共用方式為


Dispatcher.InvokeAsync 方法

定義

在與 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

要透過發送器叫用的委派。

傳回

物件,此物件是在呼叫 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 優先順序。

傳回

物件,此物件是在呼叫 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

表示是否要取消動作的物件。

傳回

物件,此物件是在呼叫 InvokeAsync(Action, DispatcherPriority, CancellationToken) 之後立即傳回的,可用來與在事件佇列中暫止執行的委派進行互動。

例外狀況

解除標記已取消。 此例外狀況會儲存在傳回的工作中。

備註

這個方法會儲存在工作中,它會傳回方法同步對應專案可以擲回的所有非使用例外狀況。 如果例外狀況儲存在傳回的工作中,則會在等候工作時擲回該例外狀況。 使用例外狀況,例如 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

表示是否要取消作業的物件。

傳回

物件,此物件是在呼叫 InvokeAsync<TResult>(Func<TResult>, DispatcherPriority, CancellationToken) 之後立即傳回的,可用來與在事件佇列中暫止執行的委派進行互動。

例外狀況

解除標記已取消。 此例外狀況會儲存在傳回的工作中。

適用於

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>

要透過發送器叫用的委派。

傳回

物件,此物件是在呼叫 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 優先順序。

傳回

物件,此物件是在呼叫 InvokeAsync<TResult>(Func<TResult>, DispatcherPriority) 之後立即傳回的,可用來與在事件佇列中暫止執行的委派進行互動。

適用於