次の方法で共有


非同期プログラミングのシナリオ

I/O バインドのニーズ (ネットワークからのデータの要求、データベースへのアクセス、ファイル システムの読み書きなど) がある場合、非同期プログラミングを利用できます。 CPU バインドのコードにも、コストのかかる計算の実行など、非同期コードに適したシナリオがあります。

C# は言語レベルで非同期プログラミング モデルを備えており、コールバックに苦労したり、非同期処理をサポートするライブラリに従ったりしなくても、非同期コードを簡単に記述できます。 C# は、タスク ベースの非同期パターン (TAP) と呼ばれるものに従います。

非同期モデルの概要

非同期プログラミングの中心になるのは Task オブジェクトと Task<T> オブジェクトであり、非同期操作をモデル化します。 これらは、async および await キーワードによってサポートされています。 ほとんどの場合、モデルは非常に単純です。

  • I/O バインドのコードでは、async メソッドの内部で、Task または Task<T> を返す操作を待機します。
  • CPU バインドのコードでは、Task.Run メソッドによってバックグラウンド スレッドで開始された操作を待機します。

await キーワードはマジックが行われる場所であり、 await を実行したメソッドの呼び出し元に制御が委譲されます。これによって最終的に、UI は応答できるようになり、サービスは柔軟性を持つようになります。 asyncawait 以外にも非同期コードを実現する方法はありますが、この記事では言語レベルのコンストラクトについて説明します。

Note

次の例の一部では、System.Net.Http.HttpClient クラスを使って Web サービスからデータをダウンロードしています。 これらの例で使われている s_httpClient オブジェクトは Program クラスの静的フィールドです (完全な例を確認してください)。

private static readonly HttpClient s_httpClient = new();

I/O バインドの例: Web サービスからデータをダウンロードする

ボタンがクリックされたら Web サービスからデータをダウンロードする必要がありますが UI スレッドはブロックしたくない、といった場合があります。 これは、次のようにして実現できます。

s_downloadButton.Clicked += async (o, e) =>
{
    // This line will yield control to the UI as the request
    // from the web service is happening.
    //
    // The UI thread is now free to perform other work.
    var stringData = await s_httpClient.GetStringAsync(URL);
    DoSomethingWithData(stringData);
};

コードでは、Task オブジェクトとの対話に煩わされることなく意図すること (データを非同期的にダウンロードする) が表されています。

CPU バインドの例: ゲームの計算を実行する

ボタンをクリックすると画面上の多くの敵にダメージを与えることができるモバイル ゲームを作っています。 ダメージ計算の実行は負荷が大きく、UI スレッドで実行すると計算の実行中はゲームが停止しているように見えます。

これを処理する最善の方法は、バックグラウンド スレッドを開始して、その中で Task.Run を使って処理を実行し、await を使用して結果を大気することです。 このようにすると、処理が行われている間も UI が停止することはありません。

static DamageResult CalculateDamageDone()
{
    return new DamageResult()
    {
        // Code omitted:
        //
        // Does an expensive calculation and returns
        // the result of that calculation.
    };
}

s_calculateButton.Clicked += async (o, e) =>
{
    // This line will yield control to the UI while CalculateDamageDone()
    // performs its work. The UI thread is free to perform other work.
    var damageResult = await Task.Run(() => CalculateDamageDone());
    DisplayDamage(damageResult);
};

このコードでは、ボタンのクリック イベントの意図が明らかに表されています。バックグラウンド スレッドを手動で管理する必要はなく、ブロッキングが発生しない方法で行われます。

内部での処理

C# 側では、コンパイラによってコードがステート マシンに変換されます。ステート マシンでは、await に達したときの実行の委譲や、バックグラウンド ジョブが終了したときの実行の再開などが追跡されます。

理論的には、これは非同期処理の約束モデルの実装です。

理解すべき重要事項

  • 非同期コードは I/O バインドと CPU バインドの両方のコードで使うことができますが、使い方はシナリオにより異なります。
  • 非同期コードで使われる Task<T>Task は、バックグラウンドで行われる処理のモデル化に使われる構成要素です。
  • キーワード async はメソッドを非同期メソッドに変換し、メソッドの本体で await キーワードを使用できるようにします。
  • 適用された await キーワードは、呼び出しメソッドを中断し、待機中のタスクが完了するまで呼び出し元に制御を戻します。
  • await は、非同期メソッドの中でのみ使用できます。

CPU バインドと I/O バインドの処理

このガイドの最初の 2 つの例では、CPU バインドと I/O バインドの処理に対して async および await を使う方法を示しました。 行う必要のあるジョブが I/O バインドか CPU バインドかを識別できることが重要です。これは、コードのパフォーマンスに大きく影響し、特定の構成の誤った使用につながるおそれがあります。

コードを記述する前に次の 2 点について考える必要があります。

  1. コードは何か (データベースのデータなど) を "待機" していますか。

    答えが "はい" の場合、その処理は I/O バインドです。

  2. コードでは、負荷の大きい計算が実行されますか。

    答えが "はい" の場合、その処理は CPU バインドです。

処理が I/O バインドの場合は、asyncawait を使いますが、Task.Run は "使いません"。 タスク並列ライブラリは "使わないでください"。

処理が CPU バインドであり、応答性が重要な場合は、asyncawait を使い、Task.Run を "使って" 別のスレッドで処理を実行します。 処理がコンカレンシーと並列処理に適している場合は、タスク並列ライブラリを使うことも考慮します。

さらに、常にコードの実行を測定する必要があります。 たとえば、マルチスレッドでのコンテキスト切り替えのオーバーヘッドと比較して、CPU バインドの処理の負荷がそれほど大きくないことがわかる場合があります。 すべての選択肢にはトレードオフがあり、状況に合った適切なトレードオフを選ぶ必要があります。

その他の例

以下では、C# で非同期コードを記述するさまざまな方法がわかる例を示します。 実際に遭遇する可能性があるいくつかの異なるシナリオを使います。

ネットワークからデータを抽出する

このスニペットを実行すると、指定した URL の HTML をダウンロードし、HTML に文字列 ".NET" が出現する回数をカウントできます。 ASP.NET を使用して Web API コントローラー メソッドが定義され、そのメソッドによってこのタスクが実行されて、値が返されます。

注意

運用コードで HTML の解析の実行を計画している場合は、正規表現を使用しないでください。 代わりに解析ライブラリを使用します。

[HttpGet, Route("DotNetCount")]
static public async Task<int> GetDotNetCount(string URL)
{
    // Suspends GetDotNetCount() to allow the caller (the web server)
    // to accept another request, rather than blocking on this one.
    var html = await s_httpClient.GetStringAsync(URL);
    return Regex.Matches(html, @"\.NET").Count;
}

次に示すのはユニバーサル Windows アプリ用に記述された同じシナリオであり、ボタンがクリックされたら同じタスクを実行します。

private readonly HttpClient _httpClient = new HttpClient();

private async void OnSeeTheDotNetsButtonClick(object sender, RoutedEventArgs e)
{
    // Capture the task handle here so we can await the background task later.
    var getDotNetFoundationHtmlTask = _httpClient.GetStringAsync("https://dotnetfoundation.org");

    // Any other work on the UI thread can be done here, such as enabling a Progress Bar.
    // This is important to do here, before the "await" call, so that the user
    // sees the progress bar before execution of this method is yielded.
    NetworkProgressBar.IsEnabled = true;
    NetworkProgressBar.Visibility = Visibility.Visible;

    // The await operator suspends OnSeeTheDotNetsButtonClick(), returning control to its caller.
    // This is what allows the app to be responsive and not block the UI thread.
    var html = await getDotNetFoundationHtmlTask;
    int count = Regex.Matches(html, @"\.NET").Count;

    DotNetCountLabel.Text = $"Number of .NETs on dotnetfoundation.org: {count}";

    NetworkProgressBar.IsEnabled = false;
    NetworkProgressBar.Visibility = Visibility.Collapsed;
}

複数タスクの完了を待機する

複数のデータを同時に取得することが必要になる場合があります。 Task API には 2 つのメソッド Task.WhenAllTask.WhenAny が含まれており、これらを使用して、複数のバックグラウンド ジョブで非ブロッキング待機を実行する非同期コードを記述できます。

次の例では、一連の userId に対する User データを取得する方法を示します。

private static async Task<User> GetUserAsync(int userId)
{
    // Code omitted:
    //
    // Given a user Id {userId}, retrieves a User object corresponding
    // to the entry in the database with {userId} as its Id.

    return await Task.FromResult(new User() { id = userId });
}

private static async Task<IEnumerable<User>> GetUsersAsync(IEnumerable<int> userIds)
{
    var getUserTasks = new List<Task<User>>();
    foreach (int userId in userIds)
    {
        getUserTasks.Add(GetUserAsync(userId));
    }

    return await Task.WhenAll(getUserTasks);
}

LINQ を使ってさらに簡潔に記述する別の方法を次に示します。

private static async Task<User[]> GetUsersAsyncByLINQ(IEnumerable<int> userIds)
{
    var getUserTasks = userIds.Select(id => GetUserAsync(id)).ToArray();
    return await Task.WhenAll(getUserTasks);
}

コードは少ないですが、LINQ と非同期コードを併用するときは注意してください。 LINQ は遅延実行を使うので、生成されたシーケンスを .ToList() または .ToArray() の呼び出しで強制的に反復処理させない限り、foreach ループ内で行われた非同期呼び出しはすぐに実行されません。 上記の例では、Enumerable.ToArray を使ってクエリを一括で実行し、結果を配列に格納しています。 これにより、コード id => GetUserAsync(id) が強制的に実行され、タスクが開始されます。

重要な情報とアドバイス

非同期プログラミングでは、いくつかの詳細を留意することによって、予期せぬ動作を防ぐことができます。

  • async メソッドの本体に await キーワードが含まれないと、何も行われません。

    これは、忘れてはならない重要なことです。 awaitasync メソッドの本体で使用されていない場合、C# コンパイラでは警告が生成されますが、コードは通常のメソッドと同様にコンパイルされて実行されます。 非同期メソッドに対して C# コンパイラによって生成されるステート マシンでは何も行われないため、これは非常に非効率的です。

  • 記述するすべての非同期メソッド名のサフィックスとして、"Async" を追加します。

    これは、同期メソッドと非同期メソッドの区別をより簡単にするために、.NET で使われる規則です。 コードによって明示的に呼び出されない一部のメソッド (イベント ハンドラーや Web コントローラー メソッドなど) には、必ずしも当てはまりません。 そのようなメソッドはコードでは明示的に呼び出されないため、明示的な命名はそれほど重要ではありません。

  • async void はイベント ハンドラーに対してのみ使う必要があります。

    イベントには戻り値の型がないため、async void は非同期イベント ハンドラーの動作を可能にする唯一の方法です (したがって、TaskTask<T> を使うことはできません)。 async void のその他の使用はすべて TAP モデルに従わないので、使うのが難しい場合があります。以下はその例です。

    • async void メソッドでスローされた例外を、そのメソッドの外部でキャッチすることはできません。
    • async void メソッドをテストするのは困難です。
    • async void メソッドでは、呼び出し元がそれを非同期と予期していないと、悪い副作用が発生する可能性があります。
  • LINQ 式での非同期ラムダの使用は慎重に行う必要があります

    LINQ 内のラムダ式では、遅延実行が使用されます。つまり、予期していないときにコードが実行される可能性があります。 これにブロッキング タスクを組み込んだ場合、正しく作成されていないと、簡単にデッドロックが発生します。 さらに、このように非同期コードを入れ子にすると、コードの実行についての推論も難しくなります。 非同期と LINQ は強力ですが、併用するときは可能な限り慎重かつ明確にする必要があります。

  • タスクを待機するコードは非ブロッキング方式で作成します

    Task が完了するのを待機するための手段として現在のスレッドをブロックすると、デッドロックおよびコンテキスト スレッドのブロックが発生するおそれがあり、複雑なエラー処理が必要になることがあります。 次の表では、非ブロッキング方式でタスクの待機に対処する方法について説明します。

    これを使う これは使わない 行う処理
    await Task.Wait または Task.Result バックグラウンド タスクの結果の取得
    await Task.WhenAny Task.WaitAny 任意のタスクの完了の待機
    await Task.WhenAll Task.WaitAll すべてのタスクの完了の待機
    await Task.Delay Thread.Sleep 一定期間の待機
  • 可能な場合は ValueTask の使用を検討する

    非同期メソッドから Task オブジェクトを返すと、特定のパスでパフォーマンスのボトルネックが発生する可能性があります。 Task は参照型です。したがって、これを使うことは、オブジェクトを割り当てることを意味します。 async 修飾子で宣言されたメソッドがキャッシュされた結果を返すか、同期的に完了する場合、追加の割り当ては、コードのパフォーマンスが重要なセクションにおいて大きな時間コストにつながります。 厳密なループ処理でこのような割り当てが発生した場合、コストがかかる場合があります。 詳しくは、「一般化された async の戻り値の型」をご覧ください。

  • ConfigureAwait(false) の使用を検討する

    "どのような場合に Task.ConfigureAwait(Boolean) メソッドを使用する必要があるか" ということが問題になることがよくあります。 このメソッドを使用すると、Task インスタンスでその awaiter を構成できます。 これは重要な考慮事項であり、それを正しく設定しないと、パフォーマンスに影響し、デッドロックが発生する可能性があります。 ConfigureAwait の詳細については、「ConfigureAwait の FAQ」を参照してください。

  • ステートフル性の低いコードを記述します

    グローバル オブジェクトの状態または特定のメソッドの実行に依存しないでください。 代わりに、メソッドの戻り値のみに依存するようにします。 なぜでしょうか。

    • コードを理解しやすくなります。
    • コードをテストしやすくなります。
    • 非同期コードと同期コードの混在がはるかに簡単になります。
    • 一般には、競合状態を完全に回避できます。
    • 戻り値に依存すると、非同期コードの調整が簡単になります。
    • (ボーナス) 依存関係の挿入で問題なく動作します。

推奨される目標は、完全またはほぼ完全な参照の透過性をコードで実現することです。 そうすることで、コードベースが予測、テストおよび保守可能になります。

コード例全体

次のコードは、この例の Program.cs ファイルの完全なテキストです。

using System.Text.RegularExpressions;
using System.Windows;
using Microsoft.AspNetCore.Mvc;

class Button
{
    public Func<object, object, Task>? Clicked
    {
        get;
        internal set;
    }
}

class DamageResult
{
    public int Damage
    {
        get { return 0; }
    }
}

class User
{
    public bool isEnabled
    {
        get;
        set;
    }

    public int id
    {
        get;
        set;
    }
}

public class Program
{
    private static readonly Button s_downloadButton = new();
    private static readonly Button s_calculateButton = new();

    private static readonly HttpClient s_httpClient = new();

    private static readonly IEnumerable<string> s_urlList = new string[]
    {
            "https://learn.microsoft.com",
            "https://learn.microsoft.com/aspnet/core",
            "https://learn.microsoft.com/azure",
            "https://learn.microsoft.com/azure/devops",
            "https://learn.microsoft.com/dotnet",
            "https://learn.microsoft.com/dotnet/desktop/wpf/get-started/create-app-visual-studio",
            "https://learn.microsoft.com/education",
            "https://learn.microsoft.com/shows/net-core-101/what-is-net",
            "https://learn.microsoft.com/enterprise-mobility-security",
            "https://learn.microsoft.com/gaming",
            "https://learn.microsoft.com/graph",
            "https://learn.microsoft.com/microsoft-365",
            "https://learn.microsoft.com/office",
            "https://learn.microsoft.com/powershell",
            "https://learn.microsoft.com/sql",
            "https://learn.microsoft.com/surface",
            "https://dotnetfoundation.org",
            "https://learn.microsoft.com/visualstudio",
            "https://learn.microsoft.com/windows",
            "https://learn.microsoft.com/maui"
    };

    private static void Calculate()
    {
        // <PerformGameCalculation>
        static DamageResult CalculateDamageDone()
        {
            return new DamageResult()
            {
                // Code omitted:
                //
                // Does an expensive calculation and returns
                // the result of that calculation.
            };
        }

        s_calculateButton.Clicked += async (o, e) =>
        {
            // This line will yield control to the UI while CalculateDamageDone()
            // performs its work. The UI thread is free to perform other work.
            var damageResult = await Task.Run(() => CalculateDamageDone());
            DisplayDamage(damageResult);
        };
        // </PerformGameCalculation>
    }

    private static void DisplayDamage(DamageResult damage)
    {
        Console.WriteLine(damage.Damage);
    }

    private static void Download(string URL)
    {
        // <UnblockingDownload>
        s_downloadButton.Clicked += async (o, e) =>
        {
            // This line will yield control to the UI as the request
            // from the web service is happening.
            //
            // The UI thread is now free to perform other work.
            var stringData = await s_httpClient.GetStringAsync(URL);
            DoSomethingWithData(stringData);
        };
        // </UnblockingDownload>
    }

    private static void DoSomethingWithData(object stringData)
    {
        Console.WriteLine("Displaying data: ", stringData);
    }

    // <GetUsersForDataset>
    private static async Task<User> GetUserAsync(int userId)
    {
        // Code omitted:
        //
        // Given a user Id {userId}, retrieves a User object corresponding
        // to the entry in the database with {userId} as its Id.

        return await Task.FromResult(new User() { id = userId });
    }

    private static async Task<IEnumerable<User>> GetUsersAsync(IEnumerable<int> userIds)
    {
        var getUserTasks = new List<Task<User>>();
        foreach (int userId in userIds)
        {
            getUserTasks.Add(GetUserAsync(userId));
        }

        return await Task.WhenAll(getUserTasks);
    }
    // </GetUsersForDataset>

    // <GetUsersForDatasetByLINQ>
    private static async Task<User[]> GetUsersAsyncByLINQ(IEnumerable<int> userIds)
    {
        var getUserTasks = userIds.Select(id => GetUserAsync(id)).ToArray();
        return await Task.WhenAll(getUserTasks);
    }
    // </GetUsersForDatasetByLINQ>

    // <ExtractDataFromNetwork>
    [HttpGet, Route("DotNetCount")]
    static public async Task<int> GetDotNetCount(string URL)
    {
        // Suspends GetDotNetCount() to allow the caller (the web server)
        // to accept another request, rather than blocking on this one.
        var html = await s_httpClient.GetStringAsync(URL);
        return Regex.Matches(html, @"\.NET").Count;
    }
    // </ExtractDataFromNetwork>

    static async Task Main()
    {
        Console.WriteLine("Application started.");

        Console.WriteLine("Counting '.NET' phrase in websites...");
        int total = 0;
        foreach (string url in s_urlList)
        {
            var result = await GetDotNetCount(url);
            Console.WriteLine($"{url}: {result}");
            total += result;
        }
        Console.WriteLine("Total: " + total);

        Console.WriteLine("Retrieving User objects with list of IDs...");
        IEnumerable<int> ids = new int[] { 1, 2, 3, 4, 5, 6, 7, 8, 9, 0 };
        var users = await GetUsersAsync(ids);
        foreach (User? user in users)
        {
            Console.WriteLine($"{user.id}: isEnabled={user.isEnabled}");
        }

        Console.WriteLine("Application ending.");
    }
}

// Example output:
//
// Application started.
// Counting '.NET' phrase in websites...
// https://learn.microsoft.com: 0
// https://learn.microsoft.com/aspnet/core: 57
// https://learn.microsoft.com/azure: 1
// https://learn.microsoft.com/azure/devops: 2
// https://learn.microsoft.com/dotnet: 83
// https://learn.microsoft.com/dotnet/desktop/wpf/get-started/create-app-visual-studio: 31
// https://learn.microsoft.com/education: 0
// https://learn.microsoft.com/shows/net-core-101/what-is-net: 42
// https://learn.microsoft.com/enterprise-mobility-security: 0
// https://learn.microsoft.com/gaming: 0
// https://learn.microsoft.com/graph: 0
// https://learn.microsoft.com/microsoft-365: 0
// https://learn.microsoft.com/office: 0
// https://learn.microsoft.com/powershell: 0
// https://learn.microsoft.com/sql: 0
// https://learn.microsoft.com/surface: 0
// https://dotnetfoundation.org: 16
// https://learn.microsoft.com/visualstudio: 0
// https://learn.microsoft.com/windows: 0
// https://learn.microsoft.com/maui: 6
// Total: 238
// Retrieving User objects with list of IDs...
// 1: isEnabled= False
// 2: isEnabled= False
// 3: isEnabled= False
// 4: isEnabled= False
// 5: isEnabled= False
// 6: isEnabled= False
// 7: isEnabled= False
// 8: isEnabled= False
// 9: isEnabled= False
// 0: isEnabled= False
// Application ending.

その他のリソース