Dispatcher.InvokeAsync Método

Definição

Namespace:

System.Windows.Threading

Assembly:

WindowsBase.dll

Executa o delegado especificado de forma assíncrona no thread ao qual o Dispatcher está associado.

Sobrecargas

InvokeAsync(Action)	Executa o Action especificado de forma assíncrona no thread ao qual o Dispatcher está associado.
InvokeAsync(Action, DispatcherPriority)	Executa o Action especificado de forma assíncrona na prioridade especificada no thread ao qual Dispatcher está associado.
InvokeAsync(Action, DispatcherPriority, CancellationToken)	Executa o Action especificado de forma assíncrona na prioridade especificada no thread ao qual Dispatcher está associado.
InvokeAsync<TResult>(Func<TResult>, DispatcherPriority, CancellationToken)	Executa o Func<TResult> especificado de forma assíncrona na prioridade especificada no thread ao qual Dispatcher está associado.
InvokeAsync<TResult>(Func<TResult>)	Executa o Func<TResult> especificado de forma assíncrona no thread ao qual o Dispatcher está associado.
InvokeAsync<TResult>(Func<TResult>, DispatcherPriority)	Executa o Func<TResult> especificado de forma assíncrona na prioridade especificada no thread ao qual Dispatcher está associado.

InvokeAsync(Action)

Executa o Action especificado de forma assíncrona no thread ao qual o Dispatcher está associado.

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

Parâmetros

callback

Action

Um delegado a ser invocado pelo dispatcher.

Retornos

DispatcherOperation

Um objeto, retornado imediatamente após InvokeAsync(Action) ser chamado, que pode ser usado para interagir com o delegado enquanto ele aguarda a execução na fila de eventos.

Comentários

A prioridade padrão é DispatcherPriority.Normal.

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Invoke(Action).

InvokeAsync(Action, DispatcherPriority)

Executa o Action especificado de forma assíncrona na prioridade especificada no thread ao qual Dispatcher está associado.

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

Parâmetros

callback

Action

Um delegado a ser invocado pelo dispatcher.

priority

DispatcherPriority

A prioridade que determina a ordem na qual o retorno de chamada especificado é invocado em relação às outras operações pendentes no Dispatcher.

Retornos

DispatcherOperation

Um objeto, retornado imediatamente após InvokeAsync(Action, DispatcherPriority) ser chamado, que pode ser usado para interagir com o delegado enquanto ele aguarda a execução na fila de eventos.

Comentários

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Invoke(Action, DispatcherPriority).

InvokeAsync(Action, DispatcherPriority, CancellationToken)

Executa o Action especificado de forma assíncrona na prioridade especificada no thread ao qual Dispatcher está associado.

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

Parâmetros

callback

Action

Um delegado a ser invocado pelo dispatcher.

priority

DispatcherPriority

A prioridade que determina a ordem na qual o retorno de chamada especificado é invocado em relação às outras operações pendentes no Dispatcher.

cancellationToken

CancellationToken

Um objeto que indica se a ação deve ser cancelada.

Retornos

DispatcherOperation

Um objeto, retornado imediatamente após InvokeAsync(Action, DispatcherPriority, CancellationToken) ser chamado, que pode ser usado para interagir com o delegado enquanto ele aguarda a execução na fila de eventos.

Exceções

OperationCanceledException

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Invoke(Action, DispatcherPriority).

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

Executa o Func<TResult> especificado de forma assíncrona na prioridade especificada no thread ao qual Dispatcher está associado.

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)

Parâmetros de tipo

TResult

O tipo de valor retornado do delegado especificado.

Parâmetros

callback

Func<TResult>

Um delegado a ser invocado pelo dispatcher.

priority

DispatcherPriority

A prioridade que determina a ordem na qual o retorno de chamada especificado é invocado em relação às outras operações pendentes no Dispatcher.

cancellationToken

CancellationToken

Um objeto que indica se a operação deve ser cancelada.

Retornos

DispatcherOperation<TResult>

Um objeto, retornado imediatamente após InvokeAsync<TResult>(Func<TResult>, DispatcherPriority, CancellationToken) ser chamado, que pode ser usado para interagir com o delegado enquanto ele aguarda a execução na fila de eventos.

Exceções

OperationCanceledException

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

InvokeAsync<TResult>(Func<TResult>)

Executa o Func<TResult> especificado de forma assíncrona no thread ao qual o Dispatcher está associado.

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)

Parâmetros de tipo

TResult

O tipo de valor retornado do delegado especificado.

Parâmetros

callback

Func<TResult>

Um delegado a ser invocado pelo dispatcher.

Retornos

DispatcherOperation<TResult>

Um objeto, retornado imediatamente após InvokeAsync<TResult>(Func<TResult>) ser chamado, que pode ser usado para interagir com o delegado enquanto ele aguarda a execução na fila de eventos.

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

Executa o Func<TResult> especificado de forma assíncrona na prioridade especificada no thread ao qual Dispatcher está associado.

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)

Parâmetros de tipo

TResult

O tipo de valor retornado do delegado especificado.

Parâmetros

callback

Func<TResult>

Um delegado a ser invocado pelo dispatcher.

priority

DispatcherPriority

A prioridade que determina a ordem na qual o retorno de chamada especificado é invocado em relação às outras operações pendentes no Dispatcher.

Retornos

DispatcherOperation<TResult>

Um objeto, retornado imediatamente após InvokeAsync<TResult>(Func<TResult>, DispatcherPriority) ser chamado, que pode ser usado para interagir com o delegado enquanto ele aguarda a execução na fila de eventos.