Dispatcher.InvokeAsync Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Executa o delegado especificado de forma assíncrona no thread ao qual está Dispatcher associado.
Sobrecargas
| Name | Description |
|---|---|
| InvokeAsync(Action) |
Executa o especificado Action de forma assíncrona no thread ao qual está Dispatcher associado. |
| InvokeAsync(Action, DispatcherPriority) |
Executa o especificado Action de forma assíncrona à prioridade especificada no thread ao qual está Dispatcher associado. |
| InvokeAsync(Action, DispatcherPriority, CancellationToken) |
Executa o especificado Action de forma assíncrona à prioridade especificada no thread ao qual está Dispatcher associado. |
| InvokeAsync<TResult>(Func<TResult>, DispatcherPriority, CancellationToken) |
Executa o especificado Func<TResult> de forma assíncrona à prioridade especificada no thread ao qual está Dispatcher associado. |
| InvokeAsync<TResult>(Func<TResult>) |
Executa o especificado Func<TResult> de forma assíncrona no thread ao qual está Dispatcher associado. |
| InvokeAsync<TResult>(Func<TResult>, DispatcherPriority) |
Executa o especificado Func<TResult> de forma assíncrona à prioridade especificada no thread ao qual está Dispatcher associado. |
InvokeAsync(Action)
Executa o especificado Action de forma assíncrona no thread ao qual está Dispatcher associado.
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 para invocar através do despachante.
Devoluções
Um objeto, que é devolvido imediatamente a seguir InvokeAsync(Action) , é chamado, que pode ser usado para interagir com o delegado enquanto este está pendente de execução na fila de eventos.
Observações
A prioridade padrão é DispatcherPriority.Normal.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Invoke(Action).
Aplica-se a
InvokeAsync(Action, DispatcherPriority)
Executa o especificado Action de forma assíncrona à prioridade especificada no thread ao qual está Dispatcher 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.DispatcherOperationPublic Function InvokeAsync (callback As Action, priority As DispatcherPriority) As DispatcherOperationParâmetros
- callback
- Action
Um delegado para invocar através do despachante.
- priority
- DispatcherPriority
A prioridade que determina a ordem em que o callback especificado é invocado em relação às outras operações pendentes no Dispatcher.
Devoluções
Um objeto, que é devolvido imediatamente a seguir InvokeAsync(Action, DispatcherPriority) , é chamado, que pode ser usado para interagir com o delegado enquanto este está pendente de execução na fila de eventos.
Observações
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Invoke(Action, DispatcherPriority).
Aplica-se a
InvokeAsync(Action, DispatcherPriority, CancellationToken)
Executa o especificado Action de forma assíncrona à prioridade especificada no thread ao qual está Dispatcher 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.DispatcherOperationPublic Function InvokeAsync (callback As Action, priority As DispatcherPriority, cancellationToken As CancellationToken) As DispatcherOperationParâmetros
- callback
- Action
Um delegado para invocar através do despachante.
- priority
- DispatcherPriority
A prioridade que determina a ordem em que o callback especificado é invocado em relação às outras operações pendentes no Dispatcher.
- cancellationToken
- CancellationToken
Um objeto que indica se deve cancelar a ação.
Devoluções
Um objeto, que é devolvido imediatamente a seguir InvokeAsync(Action, DispatcherPriority, CancellationToken) , é chamado, que pode ser usado para interagir com o delegado enquanto este está pendente de execução na fila de eventos.
Exceções
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Invoke(Action, DispatcherPriority).
Aplica-se a
InvokeAsync<TResult>(Func<TResult>, DispatcherPriority, CancellationToken)
Executa o especificado Func<TResult> de forma assíncrona à prioridade especificada no thread ao qual está Dispatcher 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 Genérico
- TResult
O tipo de valor de retorno do delegado especificado.
Parâmetros
- callback
- Func<TResult>
Um delegado para invocar através do despachante.
- priority
- DispatcherPriority
A prioridade que determina a ordem em que o callback especificado é invocado em relação às outras operações pendentes no Dispatcher.
- cancellationToken
- CancellationToken
Um objeto que indica se deve cancelar a operação.
Devoluções
Um objeto, que é devolvido imediatamente a seguir InvokeAsync<TResult>(Func<TResult>, DispatcherPriority, CancellationToken) , é chamado, que pode ser usado para interagir com o delegado enquanto este está pendente de execução na fila de eventos.
Exceções
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Aplica-se a
InvokeAsync<TResult>(Func<TResult>)
Executa o especificado Func<TResult> de forma assíncrona no thread ao qual está Dispatcher 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 Genérico
- TResult
O tipo de valor de retorno do delegado especificado.
Parâmetros
- callback
- Func<TResult>
Um delegado para invocar através do despachante.
Devoluções
Um objeto, que é devolvido imediatamente a seguir InvokeAsync<TResult>(Func<TResult>) , é chamado, que pode ser usado para interagir com o delegado enquanto este está pendente de execução na fila de eventos.
Aplica-se a
InvokeAsync<TResult>(Func<TResult>, DispatcherPriority)
Executa o especificado Func<TResult> de forma assíncrona à prioridade especificada no thread ao qual está Dispatcher 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 Genérico
- TResult
O tipo de valor de retorno do delegado especificado.
Parâmetros
- callback
- Func<TResult>
Um delegado para invocar através do despachante.
- priority
- DispatcherPriority
A prioridade que determina a ordem em que o callback especificado é invocado em relação às outras operações pendentes no Dispatcher.
Devoluções
Um objeto, que é devolvido imediatamente a seguir InvokeAsync<TResult>(Func<TResult>, DispatcherPriority) , é chamado, que pode ser usado para interagir com o delegado enquanto este está pendente de execução na fila de eventos.
