1. Task.WhenAll: すべてを一緒に待つ
現実には一つのことだけをしていることはめったにありません。ベッドから起きながら時計を見る、シャワーを浴びながら歌う、服を着ながら音楽を聴く、同時にコーヒーを用意する。あるいはコンピュータ作業なら、複数のファイルを同時にダウンロードし、何本かのネットワークリクエストを送り、いくつかの異なる方向でデータを計算する。これらの操作は並行して(そしてできれば非同期で)実行されるべきで、ユーザーの時間を無駄にしたくないですよね。各タスクを一つずつ待つのではなく、この「オーケストラ」をどう組織して、いつ全部終わったかをどう判断しますか?あるいは、逆に誰が最初に終えたかを知りたいときは?
Task.WhenAllとTask.WhenAnyは、まさにそんなシナリオに使うツールです。
WhenAllメソッド
Task.WhenAllはTaskクラスの静的メソッドで、タスクのコレクションを受け取り、渡されたすべてのタスクが完了するまで完了しない新しいタスクを返します。試験でクラスメート全員が回答を終えるまで退出しないようなイメージです。
メソッドのシグネチャ
Task Task.WhenAll(params Task[] tasks)
Task<TResult[]> Task.WhenAll<TResult>(params Task<TResult>[] tasks)
戻り値のあるタスク(Task<TResult>)用と、戻り値のない(Task)用のバージョンがあります。
簡単な例: すべてのファイルのダウンロードを待つ
3つのファイルを非同期にダウンロードしてみましょう。簡単のために遅延(Task.Delay)でダウンロードをシミュレートします。例は現実的で、動作するコードです。
using System;
using System.Threading.Tasks;
class Program
{
// 遅延でファイルのダウンロードをシミュレートし、ファイル名を返す
static async Task<string> DownloadFileAsync(string fileName)
{
Console.WriteLine($"► ダウンロード開始: {fileName}");
await Task.Delay(2000); // 2秒待つ
Console.WriteLine($"✓ ダウンロード完了: {fileName}");
return fileName;
}
static async Task Main()
{
var files = new[] { "fileA.txt", "fileB.txt", "fileC.txt" };
// すべてのダウンロードを同時に開始
var downloadTasks = new Task<string>[files.Length];
for (int i = 0; i < files.Length; i++)
{
downloadTasks[i] = DownloadFileAsync(files[i]);
}
// すべてのダウンロードの完了を待つ
string[] results = await Task.WhenAll(downloadTasks);
Console.WriteLine($"すべてのダウンロードが完了しました!一覧: {string.Join(", ", results)}");
}
}
ここで何が起きているか?
- 各タスクを順番に待っていません。3つとも並行(非同期)で開始されます。
- Task.WhenAll(downloadTasks)は、すべてのタスクが完了するまで完了しないタスクを返します。
- その後、すべてのタスクの結果を使って処理したり、画面に表示したり、次に送ったりできます。
例え
3人の配達員に3つの荷物を任せて、全員が配達を終えたときにだけ上司に報告するようなイメージです。
Task.WhenAllの動作図
sequenceDiagram
participant Program
participant タスク1
participant タスク2
participant タスク3
Program->>タスク1: 開始
Program->>タスク2: 開始
Program->>タスク3: 開始
タスク1-->>Program: 完了(他より早い場合がある)
タスク2-->>Program: 完了
タスク3-->>Program: 完了
Program->>Program: Task.WhenAllが完了、すべての結果が利用可能
もし一つのタスクがエラーで終わったら?
Task.WhenAllは、あるタスクがエラーで終了しても途中で中断しません。すべてのタスクの終了を待ちます。もし少なくとも一つで例外が発生した場合、最終的なタスクはFaulted状態になり、発生したすべての例外のコレクションが含まれます。
例
static async Task<string> MayThrowAsync(string fileName)
{
await Task.Delay(500);
if (fileName == "fileB.txt")
throw new Exception("fileB.txt のダウンロードエラー");
return fileName;
}
static async Task Main()
{
var files = new[] { "fileA.txt", "fileB.txt", "fileC.txt" };
var downloadTasks = files.Select(MayThrowAsync).ToArray();
try
{
string[] results = await Task.WhenAll(downloadTasks);
Console.WriteLine($"すべて正常: {string.Join(", ", results)}");
}
catch (Exception ex)
{
Console.WriteLine($"少なくとも一つのタスクがエラーで終了しました: {ex.Message}");
}
}
例外が発生した場合、内部のすべてのエラーを確認するには AggregateException.InnerExceptions を使ってください。
公式ドキュメント: Task.WhenAll docs
2. Task.WhenAny: 最初に完了したタスクを待つ
Task.WhenAnyも静的メソッドですが、渡されたタスクのうちどれか一つが完了(成功でもエラーでも)した時点で処理を終えます。最初に完了したタスクへの参照を返します。
シグネチャ
Task<Task> Task.WhenAny(params Task[] tasks)
Task<Task<TResult>> Task.WhenAny<TResult>(params Task<TResult>[] tasks)
例え
誰が最初にケーキを作ったか、早い者勝ちで褒める、みたいな感じです。複数のサーバーのうち、どれが一番早く応答したか知りたいときに使えます。
例: どれが速い?
using System;
using System.Threading.Tasks;
class Program
{
// 異なる速さのリクエストをシミュレート
static async Task<string> RequestAsync(string name, int delay)
{
await Task.Delay(delay);
return $"{name} は {delay} ms で完了しました";
}
static async Task Main()
{
var taskA = RequestAsync("A", 1000);
var taskB = RequestAsync("B", 700); // 最速
var taskC = RequestAsync("C", 1500);
// 最初に完了したタスクを待つ
Task<string> finished = await Task.WhenAny(taskA, taskB, taskC);
Console.WriteLine($"最初に完了したのは: {finished.Result}");
}
}
WhenAnyを使えば、どのタスクが先にゴールしたかがわかります。その後、例えば残りのタスクをCancellationTokenでキャンセルすることもできます(次の講義のトピック)。
なぜ WhenAny は結果ではなくタスクを返すのか?
どのタスクが最初に完了するか事前に分からないので、戻り値の型が何になるか分かりません。だからタスク自身を返し、結果を取り出すにはそのタスクをawaitするか、Resultプロパティを使います。
WhenAll vs WhenAny: 比較図
| メソッド | いつ発火するか | 何を返すか | 典型的なシナリオ |
|---|---|---|---|
|
すべてが完了したとき | タスク(Task/Task<T[]>) | 全ての応答やファイルを待ち、結果を集約する |
|
どれか一つのタスクが完了したとき | 最初に完了したタスク自体 | 最初の結果を使い、残りをキャンセルする |
3. WhenAll と WhenAny の組み合わせ — 実践シナリオ
時には先にどれか一つを待ってから、残りを待つ必要があったり、その逆もあります。
例: 2つのサーバー間で「ピンポン」する
2つのクローンサーバーに同時にリクエストを投げて、どちらか速い方の結果を使うパターンです。
static async Task Main()
{
var fastServer = RequestAsync("速いサーバー", 400); // 400 ms
var slowServer = RequestAsync("遅いサーバー", 2000); // 2000 ms
var completed = await Task.WhenAny(fastServer, slowServer);
Console.WriteLine(await completed);
// *任意*: ここで CancellationToken を使って未完了のタスクをキャンセルできる
}
例: すべてのデータがロードされてから処理を開始
アプリには3つのデータソースがあり、3つともロードされて初めて処理に進むべきケース:
static async Task Main()
{
var task1 = DownloadFileAsync("a.txt");
var task2 = DownloadFileAsync("b.txt");
var task3 = DownloadFileAsync("c.txt");
var all = await Task.WhenAll(task1, task2, task3);
ProcessFiles(all[0], all[1], all[2]);
}
4. Task.WhenAll と Task.WhenAny を使うときのよくあるミス
ミス1: WhenAllで最初のタスクの完了を期待すること。
初心者は Task.WhenAll が最初に完了したタスクで終了すると誤解しがちですが、実際にはすべてのタスクの完了を待ちます。
ミス2: WhenAllでの例外を無視すること。
どれか一つのタスクが例外を投げると、最終的なタスクはFaultedになります。AggregateException.InnerExceptionsを処理しないと重要なエラーを見逃す可能性があります。
ミス3: WhenAnyでResultにチェックせずアクセスすること。
最初に完了したタスクがエラーで終わっている場合、Resultにアクセスすると例外が再スローされます。アクセス前にTask.IsFaultedを確認してください。
ミス4: 並列ではなく逐次でタスクを起動してしまうこと。
例えばループ内で毎回awaitしてしまうと、Task.WhenAllを使うよりもパフォーマンスが大幅に低下します。
GO TO FULL VERSION