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) 之後立即傳回的，可用來與在事件佇列中暫止執行的委派進行互動。