先生と生徒の会話形式で理解しよう

生徒

「C#を使って、インターネット上のデータやファイルを読み書きしたいのですが、読み込み中に画面が固まってしまいます。どうすればいいですか？」

先生

「それは『同期処理』という、一つの作業が終わるまで次に行かない仕組みを使っているからですね。C#の『非同期処理』を使えば、データの読み込み中も他の作業を並行して進められるようになりますよ。」

生徒

「JSONやXMLといった難しい形式のデータでも、非同期で扱えるのでしょうか？」

先生

「もちろんです！最近のC#には、JSONやXMLを非同期で効率よく扱うための便利な機能がたくさん備わっています。初心者の方でも分かりやすく解説していきますね。」

1. JSONとXML、そして非同期処理とは？

プログラミングの世界では、データを保存したり他のプログラムに渡したりするために、特定の「形式」を使います。その代表的なものがJSON（ジェイソン）とXML（エックスエムエル）です。

JSONは「JavaScript Object Notation」の略で、人間にもコンピュータにも読みやすい形式です。最近のWebアプリやスマホアプリでは、ほぼこのJSONが使われています。一方、XMLは「Extensible Markup Language」の略で、タグを使ってデータを構造化する形式です。古いシステムや設定ファイルなどでよく見かけます。

そして、今回のメインテーマである「非同期（ひどうき）処理」とは、重たい作業（データの読み書きや通信など）をしている間、コンピュータの「待ち時間」を有効活用する技術です。料理に例えると、お湯を沸かしている間に野菜を切るようなイメージです。お湯が沸くのをじっと見つめて何もできない状態が「同期」、お湯を沸かしつつ別の作業をするのが「非同期」です。

2. なぜJSONやXMLの操作に非同期が必要なのか

大きなサイズのJSONファイルやXMLファイルを読み込むとき、コンピュータはディスクからデータを読み出すために少し時間がかかります。もし「同期処理」でこれを書くと、読み込みが終わるまでマウス操作や画面の更新がすべて止まってしまい、ユーザーは「アプリがフリーズした！」と感じてしまいます。

特に、インターネット経由でデータを取得する場合は、通信環境によって数秒かかることもあります。C#では、async（アシンク）とawait（アウェイト）というキーワードを使うことで、この待ち時間を解消し、サクサク動くアプリを作ることができます。

3. JSONを非同期で読み込む準備と基本

C#でJSONを扱うには、現在では「System.Text.Json」という公式の機能を使うのが一般的です。これを使って、ファイルからデータを非同期で読み込み、C#のクラス（データの型）に変換してみましょう。

まずは、読み込むデータの形を定義する「クラス」を作成します。これは、データの入れ物のようなものです。


using System.Text.Json;

// データの形を定義するクラス
public class User
{
    public string Name { get; set; }
    public int Age { get; set; }
}

public async Task ReadJsonAsync()
{
    string filePath = "user.json";
    
    // ファイルを非同期で開く
    using FileStream openStream = File.OpenRead(filePath);
    
    // 非同期でJSONを解析して、Userクラスのオブジェクトに変換する
    User user = await JsonSerializer.DeserializeAsync<User>(openStream);

    Console.WriteLine($"名前: {user.Name}, 年齢: {user.Age}");
}

このコードのポイントは、awaitキーワードです。これをつけることで、「データの解析が終わるまで、このスレッド（作業員）は一旦解放されて他の仕事をしてもいいよ、終わったらここに戻ってきてね」という命令になります。

4. JSONを非同期で書き込む方法

次に、プログラムの中で作ったデータをJSON形式にしてファイルに保存する方法を学びましょう。これを「シリアル化（シリアライズ）」と呼びます。複雑なデータを、一本の文字列やバイト列に並べ替えて保存可能な状態にすることを指します。


using System.Text.Json;

public async Task SaveJsonAsync()
{
    var user = new User { Name = "田中太郎", Age = 25 };
    string filePath = "save_user.json";

    // ファイルに書き込む準備
    using FileStream createStream = File.Create(filePath);
    
    // 非同期でオブジェクトをJSON形式にして書き込む
    await JsonSerializer.SerializeAsync(createStream, user);
    
    Console.WriteLine("JSONファイルの保存が完了しました！");
}

実行結果として、次のようなファイルが作成されます。


{"Name":"田中太郎","Age":25}

保存する際もawaitを使うことで、大きなデータを保存している間もアプリが快適に動作し続けます。

5. XMLを非同期で扱うための基礎知識

XMLはJSONよりも歴史が長く、少し書き方が複雑ですが、C#には強力なライブラリが用意されています。XMLの非同期操作には、主にXmlWriterやXmlReaderを非同期設定で使用するか、XDocument（LINQ to XML）を組み合わせて使います。

XMLの場合、タグを使ってデータを囲みます。例えば、<Name>田中</Name>といった形です。これらを非同期で書き出す例を見てみましょう。


using System.Xml;

public async Task WriteXmlAsync()
{
    XmlWriterSettings settings = new XmlWriterSettings { Async = true, Indent = true };
    
    using (XmlWriter writer = XmlWriter.Create("sample.xml", settings))
    {
        await writer.WriteStartDocumentAsync();
        await writer.WriteStartElementAsync(null, "Profiles", null);
        
        await writer.WriteStartElementAsync(null, "User", null);
        await writer.WriteElementStringAsync(null, "Name", null, "佐藤花子");
        await writer.WriteElementStringAsync(null, "Age", null, "30");
        await writer.WriteEndElementAsync(); // Userを閉じる
        
        await writer.WriteEndElementAsync(); // Profilesを閉じる
        await writer.FlushAsync();
    }
    Console.WriteLine("XMLファイルの書き出しに成功しました。");
}

このコードでは、一つ一つのタグを「非同期で書き出す」という処理を行っています。WriteElementStringAsyncのように、末尾にAsyncとつくメソッドが非同期用です。

6. XMLを非同期で読み込んで解析する

保存したXMLを読み込むときも、非同期処理を意識しましょう。XmlReaderを使用して、一件ずつデータを読み取っていく方法を解説します。これは、メモリを節約しながら大きなファイルを読み込むのに適しています。


using System.Xml;

public async Task ReadXmlAsync()
{
    XmlReaderSettings settings = new XmlReaderSettings { Async = true };
    
    using (XmlReader reader = XmlReader.Create("sample.xml", settings))
    {
        while (await reader.ReadAsync())
        {
            if (reader.NodeType == XmlNodeType.Element && reader.Name == "Name")
            {
                string name = await reader.ReadElementContentAsStringAsync();
                Console.WriteLine($"読み込んだ名前: {name}");
            }
        }
    }
}

このコードでは、XMLファイルの中を順番に探しに行き、「Name」というタグを見つけたらその中身を非同期で取得しています。whileループの中でawait reader.ReadAsync()を使うのが、効率的な非同期読み込みのコツです。

7. 非同期処理でよく使う用語の解説

ここまで「非同期」や「await」といった言葉を使ってきましたが、ここで一度、初心者がつまずきやすい用語を整理しておきましょう。

Task（タスク）：非同期で行われる「作業の単位」です。将来終わるはずの仕事を指します。
async（アシンク）：そのメソッドの中で非同期処理（await）を行うことを宣言するキーワードです。
await（アウェイト）：非同期作業が終わるまで待機する場所を示します。ただし、待っている間、プログラム自体は止まらずに他の処理を継続できます。
Deserialize（デシリアライズ）：JSONやXMLなどの文字列を、C#で扱える便利な「オブジェクト（データ）」に変換することです。日本語では「逆シリアル化」とも言います。
Serialize（シリアライズ）：デシリアライズの逆で、C#のデータを保存用の文字列やバイト形式に変換することです。「直列化」とも呼ばれます。

8. エラーが起きたときの対処法（例外処理）

非同期でファイルを読み書きしているとき、ファイルが存在しなかったり、JSONの形式が壊れていたりするとエラーが発生します。これをプログラミング用語で「例外」と呼びます。非同期処理でも、通常の処理と同じようにtry-catchを使ってエラーを優しく受け止めることができます。


public async Task SafeReadAsync()
{
    try
    {
        // 存在しないファイルを読み込もうとしてみる
        using FileStream fs = File.OpenRead("none.json");
        await JsonSerializer.DeserializeAsync<User>(fs);
    }
    catch (FileNotFoundException ex)
    {
        Console.WriteLine("ファイルが見つかりませんでした。パスを確認してください。");
    }
    catch (JsonException ex)
    {
        Console.WriteLine("データの形式が正しくありません。");
    }
    catch (Exception ex)
    {
        Console.WriteLine($"予想外のエラーが発生しました: {ex.Message}");
    }
}

このようにエラー対策をしておくことで、アプリが突然終了してしまうのを防ぎ、ユーザーに適切なメッセージを表示できるようになります。非同期の時こそ、どこでエラーが起きるか分からないため、丁寧なエラー対策が重要です。

9. 効率的な非同期操作のコツと注意点

非同期処理は非常に強力ですが、いくつか気を付けるべきポイントがあります。まず、awaitを忘れないことです。もしawaitを付けずに非同期メソッドを呼び出すと、作業が終わる前に次のコードが実行されてしまい、データが空っぽのまま進んでしまうといったトラブルが起きます。

また、C#の最新の機能を活用することも大切です。例えば、using宣言を使うと、ファイルの読み込みが終わった後に自動的にファイルを閉じてくれるので、メモリの無駄遣いを防ぐことができます。今回紹介したコードでも、usingを積極的に使っています。これは「スコープ（有効範囲）」が終わると同時に、使い終わった道具を片付けてくれる便利な仕組みです。

JSON操作においては、大文字・小文字の区別や、数値と文字列の違いに注意しましょう。C#のクラスで定義した名前と、JSONファイル内の名前が一致していないと、うまくデータを読み込めないことがあります。その場合は、属性（Attribute）という機能を使って名前を対応させることもできますが、まずは「名前を揃える」という基本を意識してみてください。