AsyncOperationManager クラス
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
非同期メソッドの呼び出しをサポートするクラスのコンカレンシーの管理を提供します。 このクラスは継承できません。
public ref class AsyncOperationManager abstract sealedpublic static class AsyncOperationManagertype AsyncOperationManager = classPublic Class AsyncOperationManager- 継承
-
AsyncOperationManager
次のコード例では、 クラスを AsyncOperationManager 使用して、任意のアプリケーション モデルの非同期操作をサポートするクラスを作成する方法を示します。 数値をテストして素数であるかどうかを判断するクラスを実装する方法を示します。 この計算には時間がかかる場合があるため、別のスレッドで実行されます。 進行状況レポート、増分結果、完了通知は クラスによって AsyncOperation 処理されます。これにより、クライアントのイベント ハンドラーが適切なスレッドまたはコンテキストで確実に呼び出されます。
完全なコード一覧については、「 方法: イベント ベースの非同期パターンをサポートするコンポーネントを実装する」を参照してください。 クライアント フォームの完全なコード一覧については、「 方法: イベント ベースの非同期パターンのクライアントを実装する」を参照してください。
// This method starts an asynchronous calculation.
// First, it checks the supplied task ID for uniqueness.
// If taskId is unique, it creates a new WorkerEventHandler
// and calls its BeginInvoke method to start the calculation.
public virtual void CalculatePrimeAsync(
int numberToTest,
object taskId)
{
// Create an AsyncOperation for taskId.
AsyncOperation asyncOp =
AsyncOperationManager.CreateOperation(taskId);
// Multiple threads will access the task dictionary,
// so it must be locked to serialize access.
lock (userStateToLifetime.SyncRoot)
{
if (userStateToLifetime.Contains(taskId))
{
throw new ArgumentException(
"Task ID parameter must be unique",
"taskId");
}
userStateToLifetime[taskId] = asyncOp;
}
// Start the asynchronous operation.
WorkerEventHandler workerDelegate = new WorkerEventHandler(CalculateWorker);
workerDelegate.BeginInvoke(
numberToTest,
asyncOp,
null,
null);
}
' This method starts an asynchronous calculation.
' First, it checks the supplied task ID for uniqueness.
' If taskId is unique, it creates a new WorkerEventHandler
' and calls its BeginInvoke method to start the calculation.
Public Overridable Sub CalculatePrimeAsync( _
ByVal numberToTest As Integer, _
ByVal taskId As Object)
' Create an AsyncOperation for taskId.
Dim asyncOp As AsyncOperation = _
AsyncOperationManager.CreateOperation(taskId)
' Multiple threads will access the task dictionary,
' so it must be locked to serialize access.
SyncLock userStateToLifetime.SyncRoot
If userStateToLifetime.Contains(taskId) Then
Throw New ArgumentException( _
"Task ID parameter must be unique", _
"taskId")
End If
userStateToLifetime(taskId) = asyncOp
End SyncLock
' Start the asynchronous operation.
Dim workerDelegate As New WorkerEventHandler( _
AddressOf CalculateWorker)
workerDelegate.BeginInvoke( _
numberToTest, _
asyncOp, _
Nothing, _
Nothing)
End Sub
クラスで イベント ベースの非同期パターンの概要に従って非同期動作を提供する必要がある場合は、コンカレンシー管理の問題が多数発生します。 これらの中で、アプリケーション モデルに適したスレッドまたはコンテキスト (アプリケーション、ASP.NET アプリケーション、コンソール アプリケーションなど Windows フォーム) でイベント ハンドラーを確実に呼び出す必要があります。 にはAsyncOperationManager、.NET Frameworkでサポートされているすべてのアプリケーション モデルで適切に実行されるクラスを作成するための便利な方法が用意されています。
AsyncOperationManagerクラスには、CreateOperation特定の非同期タスクの期間をSystem.ComponentModel.AsyncOperation追跡するために使用できる を返す 1 つのメソッド があります。 タスクの は System.ComponentModel.AsyncOperation 、タスクの完了時にクライアントに警告するために使用できます。 また、操作を終了せずに進行状況の更新と増分結果を投稿するためにも使用できます。
非同期クラスの実装の詳細については、「 イベント ベースの非同期パターンの実装」を参照してください。
|
Synchronization |
非同期操作の同期コンテキストを取得または設定します。 |
|
Create |
特定の非同期操作の存続期間を追跡するために使用する AsyncOperation を返します。 |
| 製品 | バージョン |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
| UWP | 10.0 |
.NET に関するフィードバック
.NET はオープンソース プロジェクトです。 フィードバックを提供するにはリンクを選択します。