DataflowBlock.SendAsync 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.
Sobrecargas
| Name | Description |
|---|---|
| SendAsync<TInput>(ITargetBlock<TInput>, TInput, CancellationToken) |
Assíncrono, oferece uma mensagem ao bloco de mensagens alvo, permitindo adiamento. |
| SendAsync<TInput>(ITargetBlock<TInput>, TInput) |
Assíncrono, oferece uma mensagem ao bloco de mensagens alvo, permitindo adiamento. |
SendAsync<TInput>(ITargetBlock<TInput>, TInput, CancellationToken)
Assíncrono, oferece uma mensagem ao bloco de mensagens alvo, permitindo adiamento.
public:
generic <typename TInput>
[System::Runtime::CompilerServices::Extension]
static System::Threading::Tasks::Task<bool> ^ SendAsync(System::Threading::Tasks::Dataflow::ITargetBlock<TInput> ^ target, TInput item, System::Threading::CancellationToken cancellationToken);public static System.Threading.Tasks.Task<bool> SendAsync<TInput>(this System.Threading.Tasks.Dataflow.ITargetBlock<TInput> target, TInput item, System.Threading.CancellationToken cancellationToken);static member SendAsync : System.Threading.Tasks.Dataflow.ITargetBlock<'Input> * 'Input * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool><Extension()>
Public Function SendAsync(Of TInput) (target As ITargetBlock(Of TInput), item As TInput, cancellationToken As CancellationToken) As Task(Of Boolean)Parâmetros de Tipo Genérico
- TInput
Especifica o tipo de dados a enviar para o alvo.
Parâmetros
- target
- ITargetBlock<TInput>
O alvo para o qual publicar os dados.
- item
- TInput
O item oferecido ao alvo.
- cancellationToken
- CancellationToken
O token de cancelamento com o qual solicitar o cancelamento da operação de envio.
Devoluções
A Task<TResult> que representa o envio assíncrono. Se o alvo aceitar e consumir o elemento oferecido durante a chamada para o SendAsync, ao regressar da chamada o resultado Task<TResult> será concluído e a sua Result propriedade retornará verdadeira. Se o alvo recusar o elemento oferecido durante a chamada, ao regressar da chamada o resultado Task<TResult> será concluído e a sua Result propriedade retornará falsa. Se o alvo adiar o elemento oferecido, o elemento será armazenado em buffer até ao momento em que o alvo o consuma ou liberte, momento em que a Tarefa será concluída, indicando Result se a mensagem foi consumida. Se o alvo nunca tentar consumir ou libertar a mensagem, a tarefa devolvida nunca será concluída.
Se o cancelamento for solicitado antes de o destino ter consumido com sucesso os dados enviados, a tarefa devolvida será concluída no estado Cancelado e os dados deixarão de estar disponíveis para o alvo.
Exceções
O target é nulo (Nada em Visual Basic).
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Aplica-se a
SendAsync<TInput>(ITargetBlock<TInput>, TInput)
Assíncrono, oferece uma mensagem ao bloco de mensagens alvo, permitindo adiamento.
public:
generic <typename TInput>
[System::Runtime::CompilerServices::Extension]
static System::Threading::Tasks::Task<bool> ^ SendAsync(System::Threading::Tasks::Dataflow::ITargetBlock<TInput> ^ target, TInput item);public static System.Threading.Tasks.Task<bool> SendAsync<TInput>(this System.Threading.Tasks.Dataflow.ITargetBlock<TInput> target, TInput item);static member SendAsync : System.Threading.Tasks.Dataflow.ITargetBlock<'Input> * 'Input -> System.Threading.Tasks.Task<bool><Extension()>
Public Function SendAsync(Of TInput) (target As ITargetBlock(Of TInput), item As TInput) As Task(Of Boolean)Parâmetros de Tipo Genérico
- TInput
Especifica o tipo de dados a enviar para o alvo.
Parâmetros
- target
- ITargetBlock<TInput>
O alvo para o qual publicar os dados.
- item
- TInput
O item oferecido ao alvo.
Devoluções
A Task<TResult> que representa o envio assíncrono. Se o alvo aceitar e consumir o elemento oferecido durante a chamada para SendAsync<TInput>(ITargetBlock<TInput>, TInput), ao regressar da chamada o resultado Task<TResult> será concluído e a sua Result propriedade retornará true. Se o alvo recusar o elemento oferecido durante a chamada, ao regressar da chamada o resultado Task<TResult> será concluído e a sua Result propriedade devolverá false. Se o alvo adiar o elemento oferecido, o elemento será armazenado em buffer até ao momento em que o alvo o consuma ou liberte, momento em que a tarefa será concluída, indicando Result se a mensagem foi consumida. Se o alvo nunca tentar consumir ou libertar a mensagem, a tarefa devolvida nunca será concluída.
Exceções
O target é null.