DataflowBlock.SendAsync Método

Definição

Namespace:

System.Threading.Tasks.Dataflow

Assembly:

System.Threading.Tasks.Dataflow.dll

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

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

Task<Boolean>

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

ArgumentNullException

O target é nulo (Nothing no Visual Basic).

OperationCanceledException

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

SendAsync<TInput>(ITargetBlock<TInput>, TInput)

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

Task<Boolean>

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

ArgumentNullException

O target é null.