Dispatcher.InvokeAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Executa o delegado especificado de forma assíncrona no thread ao qual ele Dispatcher está associado.
Sobrecargas
| Nome | Description |
|---|---|
| InvokeAsync(Action) |
Executa a especificada Action de forma assíncrona no thread ao qual ela Dispatcher está associada. |
| InvokeAsync(Action, DispatcherPriority) |
Executa a especificada Action de forma assíncrona na prioridade especificada no thread ao qual ela Dispatcher está associada. |
| InvokeAsync(Action, DispatcherPriority, CancellationToken) |
Executa a especificada Action de forma assíncrona na prioridade especificada no thread ao qual ela Dispatcher está associada. |
| InvokeAsync<TResult>(Func<TResult>, DispatcherPriority, CancellationToken) |
Executa a especificada Func<TResult> de forma assíncrona na prioridade especificada no thread ao qual ela Dispatcher está associada. |
| InvokeAsync<TResult>(Func<TResult>) |
Executa a especificada Func<TResult> de forma assíncrona no thread ao qual ela Dispatcher está associada. |
| InvokeAsync<TResult>(Func<TResult>, DispatcherPriority) |
Executa a especificada Func<TResult> de forma assíncrona na prioridade especificada no thread ao qual ela Dispatcher está associada. |
InvokeAsync(Action)
Executa a especificada Action de forma assíncrona no thread ao qual ela Dispatcher está associada.
public:
System::Windows::Threading::DispatcherOperation ^ InvokeAsync(Action ^ callback);public System.Windows.Threading.DispatcherOperation InvokeAsync(Action callback);member this.InvokeAsync : Action -> System.Windows.Threading.DispatcherOperationPublic Function InvokeAsync (callback As Action) As DispatcherOperationParâmetros
- callback
- Action
Um delegado a ser invocado por meio do dispatcher.
Retornos
Um objeto, que é retornado imediatamente após InvokeAsync(Action) ser chamado, que pode ser usado para interagir com o delegado, pois ele está aguardando 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).
Aplica-se a
InvokeAsync(Action, DispatcherPriority)
Executa a especificada Action de forma assíncrona na prioridade especificada no thread ao qual ela Dispatcher está associada.
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.DispatcherOperationPublic Function InvokeAsync (callback As Action, priority As DispatcherPriority) As DispatcherOperationParâmetros
- callback
- Action
Um delegado a ser invocado por meio do 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
Um objeto, que é retornado imediatamente após InvokeAsync(Action, DispatcherPriority) ser chamado, que pode ser usado para interagir com o delegado, pois ele está aguardando 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).
Aplica-se a
InvokeAsync(Action, DispatcherPriority, CancellationToken)
Executa a especificada Action de forma assíncrona na prioridade especificada no thread ao qual ela Dispatcher está associada.
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.DispatcherOperationPublic Function InvokeAsync (callback As Action, priority As DispatcherPriority, cancellationToken As CancellationToken) As DispatcherOperationParâmetros
- callback
- Action
Um delegado a ser invocado por meio do 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
Um objeto, que é retornado imediatamente após InvokeAsync(Action, DispatcherPriority, CancellationToken) ser chamado, que pode ser usado para interagir com o delegado, pois ele está aguardando execução na fila de eventos.
Exceções
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).
Aplica-se a
InvokeAsync<TResult>(Func<TResult>, DispatcherPriority, CancellationToken)
Executa a especificada Func<TResult> de forma assíncrona na prioridade especificada no thread ao qual ela Dispatcher está associada.
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 por meio do 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
Um objeto, que é retornado imediatamente após InvokeAsync<TResult>(Func<TResult>, DispatcherPriority, CancellationToken) ser chamado, que pode ser usado para interagir com o delegado, pois ele está aguardando execução na fila de eventos.
Exceções
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
Aplica-se a
InvokeAsync<TResult>(Func<TResult>)
Executa a especificada Func<TResult> de forma assíncrona no thread ao qual ela Dispatcher está associada.
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 por meio do dispatcher.
Retornos
Um objeto, que é retornado imediatamente após InvokeAsync<TResult>(Func<TResult>) ser chamado, que pode ser usado para interagir com o delegado, pois ele está aguardando execução na fila de eventos.
Aplica-se a
InvokeAsync<TResult>(Func<TResult>, DispatcherPriority)
Executa a especificada Func<TResult> de forma assíncrona na prioridade especificada no thread ao qual ela Dispatcher está associada.
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 por meio do 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
Um objeto, que é retornado imediatamente após InvokeAsync<TResult>(Func<TResult>, DispatcherPriority) ser chamado, que pode ser usado para interagir com o delegado, pois ele está aguardando execução na fila de eventos.