Dispatcher.InvokeAsync メソッド

定義

名前空間:

System.Windows.Threading

アセンブリ:

WindowsBase.dll

Dispatcher が関連付けられているスレッドで、指定したデリゲートを非同期に実行します。

オーバーロード

InvokeAsync(Action)	Action が関連付けられているスレッドで、指定した Dispatcher を非同期に実行します。
InvokeAsync(Action, DispatcherPriority)	Action が関連付けられているスレッドで、指定した Dispatcher を指定した優先順位で非同期的に実行します。
InvokeAsync(Action, DispatcherPriority, CancellationToken)	Action が関連付けられているスレッドで、指定した Dispatcher を指定した優先順位で非同期的に実行します。
InvokeAsync<TResult>(Func<TResult>, DispatcherPriority, CancellationToken)	Func<TResult> が関連付けられているスレッドで、指定した Dispatcher を指定した優先順位で非同期的に実行します。
InvokeAsync<TResult>(Func<TResult>)	Func<TResult> が関連付けられているスレッドで、指定した Dispatcher を非同期に実行します。
InvokeAsync<TResult>(Func<TResult>, DispatcherPriority)	Func<TResult> が関連付けられているスレッドで、指定した Dispatcher を指定した優先順位で非同期的に実行します。

InvokeAsync(Action)

Action が関連付けられているスレッドで、指定した Dispatcher を非同期に実行します。

public:
 System::Windows::Threading::DispatcherOperation ^ InvokeAsync(Action ^ callback);

public System.Windows.Threading.DispatcherOperation InvokeAsync (Action callback);

member this.InvokeAsync : Action -> System.Windows.Threading.DispatcherOperation

Public Function InvokeAsync (callback As Action) As DispatcherOperation

パラメーター

callback

Action

ディスパッチャーを通じて呼び出すデリゲート。

戻り値

DispatcherOperation

InvokeAsync(Action) の呼び出し直後に返されるオブジェクト。このオブジェクトを使用して、イベント キューで実行が保留になっているデリゲートと対話できます。

注釈

既定の優先度は です DispatcherPriority.Normal。

このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって Invoke(Action)スローされる例外に関するページを参照してください。

InvokeAsync(Action, DispatcherPriority)

Action が関連付けられているスレッドで、指定した Dispatcher を指定した優先順位で非同期的に実行します。

public:
 System::Windows::Threading::DispatcherOperation ^ InvokeAsync(Action ^ callback, System::Windows::Threading::DispatcherPriority priority);

public System.Windows.Threading.DispatcherOperation InvokeAsync (Action callback, System.Windows.Threading.DispatcherPriority priority);

member this.InvokeAsync : Action * System.Windows.Threading.DispatcherPriority -> System.Windows.Threading.DispatcherOperation

Public Function InvokeAsync (callback As Action, priority As DispatcherPriority) As DispatcherOperation

パラメーター

callback

Action

ディスパッチャーを通じて呼び出すデリゲート。

priority

DispatcherPriority

内の他の保留中の操作を基準にして、指定したコールバックが呼び出される順序を Dispatcher決定する優先順位。

戻り値

DispatcherOperation

InvokeAsync(Action, DispatcherPriority) の呼び出し直後に返されるオブジェクト。このオブジェクトを使用して、イベント キューで実行が保留になっているデリゲートと対話できます。

注釈

このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって Invoke(Action, DispatcherPriority)スローされる例外に関するページを参照してください。

InvokeAsync(Action, DispatcherPriority, CancellationToken)

Action が関連付けられているスレッドで、指定した Dispatcher を指定した優先順位で非同期的に実行します。

public:
 System::Windows::Threading::DispatcherOperation ^ InvokeAsync(Action ^ callback, System::Windows::Threading::DispatcherPriority priority, System::Threading::CancellationToken cancellationToken);

public System.Windows.Threading.DispatcherOperation InvokeAsync (Action callback, System.Windows.Threading.DispatcherPriority priority, System.Threading.CancellationToken cancellationToken);

member this.InvokeAsync : Action * System.Windows.Threading.DispatcherPriority * System.Threading.CancellationToken -> System.Windows.Threading.DispatcherOperation

Public Function InvokeAsync (callback As Action, priority As DispatcherPriority, cancellationToken As CancellationToken) As DispatcherOperation

パラメーター

callback

Action

ディスパッチャーを通じて呼び出すデリゲート。

priority

DispatcherPriority

内の他の保留中の操作を基準にして、指定したコールバックが呼び出される順序を Dispatcher決定する優先順位。

cancellationToken

CancellationToken

アクションをキャンセルするかどうかを示すオブジェクト。

戻り値

DispatcherOperation

InvokeAsync(Action, DispatcherPriority, CancellationToken) の呼び出し直後に返されるオブジェクト。このオブジェクトを使用して、イベント キューで実行が保留になっているデリゲートと対話できます。

例外

OperationCanceledException

キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。

注釈

このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって Invoke(Action, DispatcherPriority)スローされる例外に関するページを参照してください。

InvokeAsync<TResult>(Func<TResult>, DispatcherPriority, CancellationToken)

Func<TResult> が関連付けられているスレッドで、指定した Dispatcher を指定した優先順位で非同期的に実行します。

public:
generic <typename TResult>
 System::Windows::Threading::DispatcherOperation<TResult> ^ InvokeAsync(Func<TResult> ^ callback, System::Windows::Threading::DispatcherPriority priority, System::Threading::CancellationToken cancellationToken);

public System.Windows.Threading.DispatcherOperation<TResult> InvokeAsync<TResult> (Func<TResult> callback, System.Windows.Threading.DispatcherPriority priority, System.Threading.CancellationToken cancellationToken);

member this.InvokeAsync : Func<'Result> * System.Windows.Threading.DispatcherPriority * System.Threading.CancellationToken -> System.Windows.Threading.DispatcherOperation<'Result>

Public Function InvokeAsync(Of TResult) (callback As Func(Of TResult), priority As DispatcherPriority, cancellationToken As CancellationToken) As DispatcherOperation(Of TResult)

型パラメーター

TResult

指定されたデリゲートの戻り値の型。

パラメーター

callback

Func<TResult>

ディスパッチャーを通じて呼び出すデリゲート。

priority

DispatcherPriority

内の他の保留中の操作を基準にして、指定したコールバックが呼び出される順序を Dispatcher決定する優先順位。

cancellationToken

CancellationToken

操作をキャンセルするかどうかを示すオブジェクト。

戻り値

DispatcherOperation<TResult>

InvokeAsync<TResult>(Func<TResult>, DispatcherPriority, CancellationToken) の呼び出し直後に返されるオブジェクト。このオブジェクトを使用して、イベント キューで実行が保留になっているデリゲートと対話できます。

例外

OperationCanceledException

キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。

InvokeAsync<TResult>(Func<TResult>)

Func<TResult> が関連付けられているスレッドで、指定した Dispatcher を非同期に実行します。

public:
generic <typename TResult>
 System::Windows::Threading::DispatcherOperation<TResult> ^ InvokeAsync(Func<TResult> ^ callback);

public System.Windows.Threading.DispatcherOperation<TResult> InvokeAsync<TResult> (Func<TResult> callback);

member this.InvokeAsync : Func<'Result> -> System.Windows.Threading.DispatcherOperation<'Result>

Public Function InvokeAsync(Of TResult) (callback As Func(Of TResult)) As DispatcherOperation(Of TResult)

型パラメーター

TResult

指定されたデリゲートの戻り値の型。

パラメーター

callback

Func<TResult>

ディスパッチャーを通じて呼び出すデリゲート。

戻り値

DispatcherOperation<TResult>

InvokeAsync<TResult>(Func<TResult>) の呼び出し直後に返されるオブジェクト。このオブジェクトを使用して、イベント キューで実行が保留になっているデリゲートと対話できます。

InvokeAsync<TResult>(Func<TResult>, DispatcherPriority)

Func<TResult> が関連付けられているスレッドで、指定した Dispatcher を指定した優先順位で非同期的に実行します。

public:
generic <typename TResult>
 System::Windows::Threading::DispatcherOperation<TResult> ^ InvokeAsync(Func<TResult> ^ callback, System::Windows::Threading::DispatcherPriority priority);

public System.Windows.Threading.DispatcherOperation<TResult> InvokeAsync<TResult> (Func<TResult> callback, System.Windows.Threading.DispatcherPriority priority);

member this.InvokeAsync : Func<'Result> * System.Windows.Threading.DispatcherPriority -> System.Windows.Threading.DispatcherOperation<'Result>

Public Function InvokeAsync(Of TResult) (callback As Func(Of TResult), priority As DispatcherPriority) As DispatcherOperation(Of TResult)

型パラメーター

TResult

指定されたデリゲートの戻り値の型。

パラメーター

callback

Func<TResult>

ディスパッチャーを通じて呼び出すデリゲート。

priority

DispatcherPriority

内の他の保留中の操作を基準にして、指定したコールバックが呼び出される順序を Dispatcher決定する優先順位。

戻り値

DispatcherOperation<TResult>

InvokeAsync<TResult>(Func<TResult>, DispatcherPriority) の呼び出し直後に返されるオブジェクト。このオブジェクトを使用して、イベント キューで実行が保留になっているデリゲートと対話できます。