AsyncOperationManager クラス

定義

名前空間:

System.ComponentModel

アセンブリ:

System.ComponentModel.EventBasedAsync.dll

ソース:

AsyncOperationManager.cs

非同期メソッドの呼び出しをサポートするクラスのコンカレンシーの管理を提供します。 このクラスは継承できません。

public ref class AsyncOperationManager abstract sealed

public static class AsyncOperationManager

type AsyncOperationManager = class

Public Class AsyncOperationManager

継承

Object

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 、タスクの完了時にクライアントに警告するために使用できます。 また、操作を終了せずに進行状況の更新と増分結果を投稿するためにも使用できます。

非同期クラスの実装の詳細については、「 イベント ベースの非同期パターンの実装」を参照してください。

プロパティ

SynchronizationContext

非同期操作の同期コンテキストを取得または設定します。

メソッド

CreateOperation(Object)

特定の非同期操作の存続期間を追跡するために使用する AsyncOperation を返します。

こちらもご覧ください

• AsyncOperation
• イベントベースの非同期パターンの実装
• マネージド スレッド処理の実施