CodeGym /コース /C# SELF /非同期メソッドの構造( async/ await)

非同期メソッドの構造( async/ await)

C# SELF
レベル 59, レッスン 3
使用可能

1. はじめに

あなたのコードをお店のレジ待ち行列だと想像してみてください。同期メソッドを実行すると、列全体(あなたのスレッド)はレジ係が一人の客の対応を終えるのを待ってから次に進みます。非同期メソッドなら、商品をレジに置いて自分のやることに戻り、レジ係が片付いたら「呼んで」くれる感じです。

.NET の非同期メソッド(async-メソッド)は、シグネチャに特別な「印」(async)を付けた普通のメソッドで、内部で await を使ってネットワークやファイル操作などの他の非同期操作をメインスレッドをブロックせずに待てるようにします。この「印」があることで、退屈な同期の店が行列なしの超近代的サービスに変わります。

非同期メソッドの基本シグネチャ

非同期メソッドはシグネチャに async 修飾子を付けて宣言します。基本例:

public async Task MyAsyncMethod()
{
    // あなたの非同期コードはこちら
}

非同期メソッドの戻り値の種類:

戻り値の型 説明 例
Task
メソッドは非同期で動くが結果は返さない
public async Task SaveFileAsync()
Task<T>
メソッドは非同期で動き、型 T の結果を返す
public async Task<int> GetSumAsync()
void
イベント専用。その他では推奨されない!
public async void Button_Click(...)
ValueTask / ValueTask<T>
結果が同期的に準備できることが多い高パフォーマンス向けシナリオ向け —

重要: async void はイベントハンドラ以外で使わないでください!そうしないと適切な例外処理ができなくなります。

2. 簡単な非同期メソッドの例

練習用のアプリ(普通のコンソールアプリだと思ってください)に、ネットワークからデータを取得する非同期メソッドを追加します。遅延はエミュレートします。

using System;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        Console.WriteLine("非同期メソッドを開始しています...");
        await MyFakeDownloadAsync();
        Console.WriteLine("非同期操作が完了しました!");
    }

    static async Task MyFakeDownloadAsync()
    {
        Console.WriteLine("ダウンロードを開始します(2秒の遅延をエミュレート)...");
        await Task.Delay(2000); // 長い操作をエミュレート
        Console.WriteLine("ダウンロードが完了しました!");
    }
}

例についてのコメント:

  • キーワード async は Main と MyFakeDownloadAsync に付いています。
  • オペレーター await は async とマークされたメソッド内でのみ使えます。
  • メソッド Task.Delay(2000) は長い操作(例: ネットワークリクエスト)をエミュレートします。
  • await の登場後、スレッドはブロックされません — Main の実行は遅延の完了まで「一時停止」します。

3. 非同期メソッドは内部でどう動くのか

コンパイラが async が付いたメソッドを見つけると、そのメソッドを「ステートマシン」に変換します。ステートマシンは停止箇所、ローカル変数を覚えておき、await した操作が完了したら実行を続けます。

とても単純化した図:


+-----------------------------------------------------------+
|          非同期メソッドの呼び出し(例: await X)         |
+-------------------------+---------------------------------+
                          |
                          v
            操作は完了しているか? (Task.Completed ではないか)
                |                  |
                | はい             | いいえ
                v                  v
          実行を一時停止         すぐに結果を返す
          して、コンテキストを   (または例外を投げる)
          保存する
                |
      非同期操作が完了する...
                |
                v
        ステートマシンがメソッドを「起こし」、
        await の次の場所から実行を再開する

詳細を暗記する必要はありません: 停止箇所とローカル変数(コンテキスト)は保存され、操作完了時に自動で復元されます。

async と await を使える(使えない)場所

  • async はメソッド宣言(またはラムダ)の前に置きます。
  • async メソッド内では await を使うのが普通で推奨されます。
  • async のないメソッドで await を書くとコンパイルエラーになります。
  • async を付けてもメソッド内に await が一つもないと警告が出ます;その場合メソッドは同期的に実行され完了済みの Task を返します。

4. 戻り値のバリエーションと特徴

戻り値が Task

メソッドが非同期の処理を行い値を返さない場合は Task を使います:

public async Task SaveToFileAsync(string path)
{
    await Task.Delay(1000);
    // ファイルに何かを保存する
}

戻り値が Task<T>

結果が必要な場合は Task<T> を使います:

public async Task<int> CalculateAsync()
{
    await Task.Delay(500);
    return 42;
}

呼び出し方:

int result = await CalculateAsync();

戻り値が async void

イベント用だけに使ってください。例えばボタンクリックハンドラ:

private async void Button_Click(object sender, EventArgs e)
{
    await Task.Delay(1000);
    // 何か別のことをする
}

なぜ通常のメソッドで async void を使ってはいけないのか?そのメソッドがいつ完了するか分からず、中で発生した例外を正しくキャッチできなくなるからです。

戻り値が ValueTask / ValueTask<T>

高パフォーマンス向けのライブラリ向けに導入されました。結果が多くの場合同期的に既に用意されているなら、余計な Task の割り当てを避けられます。初心者のうちは使わなくていいことが多いです。

5. 例: 結果を返す非同期電卓

プログラムが2つの数の合計を「遅延付き」で計算する例 — まるでとても重い計算のように:

using System;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        Console.WriteLine("最初の数を入力してください:");
        int a = int.Parse(Console.ReadLine()!);

        Console.WriteLine("2番目の数を入力してください:");
        int b = int.Parse(Console.ReadLine()!);

        Console.WriteLine("計算を実行しています...");
        int sum = await CalculateSumAsync(a, b);
        Console.WriteLine($"合計: {sum}");
    }

    static async Task<int> CalculateSumAsync(int x, int y)
    {
        await Task.Delay(2000); // 「長い」操作
        return x + y;
    }
}

ここで重要な点:

  • CalculateSumAsync は非同期メソッドで Task<int> を返し、内部で await を使っています。
  • Main での呼び出しは await を使って行われます(補足: C# 7.1 以降、Main は非同期にできます)。
  • 合計を計算している間、スレッドはブロックされずに進行状況を表示したり別の作業を行えます。

6. ネストされたメソッドとネストされた await

非同期メソッドは別の非同期メソッドを呼べますし、そのメソッドがさらに別を呼ぶこともできます。チェーン全体が自動的に続行されます:

public async Task<int> StartWorkAsync()
{
    int data = await GetDataAsync();
    int result = await ProcessDataAsync(data);
    return result;
}

簡単です: ある操作の完了を待ってから次の操作を待ちます。

7. 落とし穴とよくあるミス

1. async を忘れないで!
async を忘れてメソッド内に await を書くとコンパイラが怒り、ビルドできません。

2. 通常のメソッドで async void を使わないで
イベントハンドラ以外の非同期 void メソッドは例外の「ブラックホール」です。中で発生したエラーが消えてしまう可能性があります。

3. 非同期メソッドなのに await がない
これは可能ですが意味が薄い — メソッドは同期的に実行され、既に完了した Task を返します。

public async Task DoNothingAsync()
{
    // あら、await がない!
}

4. 非同期でないメソッドから Task を返す
API の統一のために使われます: ある操作は本当に非同期で、別の操作は瞬時に終わる場合があります。

public Task<int> Foo()
{
    // return 42; // これはダメ!
    return Task.FromResult(42); // 可能、でもここに非同期性はない。
}
2
タスク
C# SELF, レベル 59, レッスン 3
ロック未解除
非同期データのダウンロード
非同期データのダウンロード
コメント
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION