DataflowBlock.SendAsync 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.
Sobrecargas
| SendAsync<TInput>(ITargetBlock<TInput>, TInput, CancellationToken) |
Oferece assincronamente uma mensagem para o bloco de mensagens de destino, permitindo adiamento. |
| SendAsync<TInput>(ITargetBlock<TInput>, TInput) |
Oferece assincronamente uma mensagem para o bloco de mensagens de destino, permitindo adiamento. |
SendAsync<TInput>(ITargetBlock<TInput>, TInput, CancellationToken)
- Origem:
- DataflowBlock.cs
- Origem:
- DataflowBlock.cs
- Origem:
- DataflowBlock.cs
Oferece assincronamente uma mensagem para o bloco de mensagens de destino, 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
- TInput
Especifica o tipo dos dados a serem postados no destino.
Parâmetros
- target
- ITargetBlock<TInput>
O destino no qual os dados serão publicados.
- item
- TInput
O item que está sendo oferecido para o destino.
- cancellationToken
- CancellationToken
O token de cancelamento com o qual solicitar o cancelamento da operação de envio.
Retornos
Um Task<TResult> que representa o envio assíncrono. Se o destino aceitar e consumir o elemento oferecido durante a chamada para SendAsync, após o retorno da chamada, o resultado Task<TResult> será concluído e sua Result propriedade retornará true. Se o destino recusar o elemento oferecido durante a chamada, ao retornar da chamada, o resultado Task<TResult> será concluído e sua Result propriedade retornará false. Se o destino adiar o elemento oferecido, o elemento será armazenado em buffer até que o destino o consuma ou o libere, momento em que a Tarefa será concluída, indicando Result se a mensagem foi consumida. Se o destino nunca tentar consumir ou liberar a mensagem, a tarefa retornada nunca será concluída.
Se o cancelamento for solicitado antes do destino ter consumido com êxito os dados enviados, a tarefa retornada será concluída no estado Cancelado e os dados não estarão mais disponíveis para o destino.
Exceções
O target é nulo (Nothing no Visual Basic).
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
Aplica-se a
SendAsync<TInput>(ITargetBlock<TInput>, TInput)
- Origem:
- DataflowBlock.cs
- Origem:
- DataflowBlock.cs
- Origem:
- DataflowBlock.cs
Oferece assincronamente uma mensagem para o bloco de mensagens de destino, 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
- TInput
Especifica o tipo dos dados a serem postados no destino.
Parâmetros
- target
- ITargetBlock<TInput>
O destino no qual os dados serão publicados.
- item
- TInput
O item que está sendo oferecido para o destino.
Retornos
Um Task<TResult> que representa o envio assíncrono. Se o destino aceitar e consumir o elemento oferecido durante a chamada para SendAsync<TInput>(ITargetBlock<TInput>, TInput), após retornar da chamada, o Task<TResult> resultante será concluído e sua propriedade Result retornará true. Se o destino recusar o elemento oferecido durante a chamada, após retornar da chamada, o Task<TResult> resultante será concluído e sua propriedade Result retornará false. Se o destino adiar o elemento oferecido, este será armazenado em buffer até o momento em que o destino o consumir ou liberar, quando então a tarefa estará concluída, com seu Result indicando se a mensagem foi consumida. Se o destino nunca tentar consumir ou liberar a mensagem, a tarefa retornada nunca será concluída.
Exceções
O target é null.
