Dispatcher.InvokeAsync メソッド

定義

名前空間:: System.Windows.Threading

アセンブリ:: WindowsBase.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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)が呼び出された直後に返されるオブジェクト。このオブジェクトは、イベントキューでの実行が保留中であるため、デリゲートとの対話に使用できます。

適用対象

フィードバック

このページはお役に立ちましたか?