JoinableTaskContext クラス

定義

public ref class JoinableTaskContext : IDisposable, Microsoft::VisualStudio::Threading::IHangReportContributor

public class JoinableTaskContext : IDisposable, Microsoft.VisualStudio.Threading.IHangReportContributor

type JoinableTaskContext = class
    interface IHangReportContributor
    interface IDisposable

Public Class JoinableTaskContext
Implements IDisposable, IHangReportContributor

継承

Object

JoinableTaskContext

実装

IHangReportContributor IDisposable

注釈

JoinableTasks を使用または操作するときに厳密に従う必要がある規則は 3 つあります。1。 メソッドに特定のスレッド アパートメント要件 (STA または MTA) がある場合は、次のいずれかを行う必要があります。a) 非同期シグネチャを持ち、最初に互換性のあるスレッドで呼び出されていない場合は、適切なスレッドに非同期的にマーシャリングします。 メイン スレッドに切り替えるには、次の方法をお勧めします。

await JoinableTaskFactory.SwitchToMainThreadAsync();

b) 同期署名があり、間違ったスレッドで呼び出されたときに例外をスローします。 特に、別のスレッドに作業を同期的にマーシャリングするメソッドは許可されていません (その作業が完了している間はブロックされます)。 一般的に同期ブロックは、可能な限り回避する必要があります。 2. 既に出荷されているパブリック API の実装で、完了のために非同期コードとブロックを呼び出す必要がある場合は、次の単純なパターンに従ってこれを行う必要があります。

JoinableTaskFactory.Run(async delegate {
    await SomeOperationAsync(...);
});

3. 以前に開始された作業を待っている場合は、その作業を参加させる必要があります。 たとえば、1 つのサービスが、後で同期的にブロックされる可能性のある非同期作業を開始します。

JoinableTask longRunningAsyncWork = JoinableTaskFactory.RunAsync(async delegate {
    await SomeOperationAsync(...);
});

その後、非同期作業がブロックされます。

longRunningAsyncWork.Join();

または、次の場合があります。

await longRunningAsyncWork;

ただし、非同期操作を開始した直後に待機する場合は、この追加の手順は必要ありません。

スレッド セーフ

この型は、すべてのメンバーに対してスレッド セーフです。