DataflowBlock.SendAsync DataflowBlock.SendAsync DataflowBlock.SendAsync DataflowBlock.SendAsync Method

Definición

Sobrecargas

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

De forma asincrónica proporciona un mensaje al bloque de mensajes de destino, teniendo en cuenta el aplazamiento.Asynchronously offers a message to the target message block, allowing for postponement.

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

De forma asincrónica proporciona un mensaje al bloque de mensajes de destino, teniendo en cuenta el aplazamiento.Asynchronously offers a message to the target message block, allowing for postponement.

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

De forma asincrónica proporciona un mensaje al bloque de mensajes de destino, teniendo en cuenta el aplazamiento.Asynchronously offers a message to the target message block, allowing for postponement.

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>

Parámetros de tipo

TInput

Especifica el tipo de los datos que se van a enviar al destino.Specifies the type of the data to post to the target.

Parámetros

target
ITargetBlock<TInput> ITargetBlock<TInput> ITargetBlock<TInput> ITargetBlock<TInput>

El destino en el que se van a exponer los datos.The target to which to post the data.

item
TInput TInput TInput TInput

Elemento que se va a ofrecer al destino.The item being offered to the target.

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

El token de cancelación con el que solicitar la cancelación de la operación de envío.The cancellation token with which to request cancellation of the send operation.

Devoluciones

Task<TResult> que representa el envío asincrónico.A Task<TResult> that represents the asynchronous send. Si el destino acepta y usa el elemento proporcionado durante la llamada a SendAsync, al volver de la llamada se completará el Task<TResult> resultante y su propiedad Result devolverá true.If the target accepts and consumes the offered element during the call to SendAsync, upon return from the call the resulting Task<TResult> will be completed and its Result property will return true. Si el destino rechaza el elemento proporcionado durante la llamada, al volver de la llamada se completará el Task<TResult> resultante y su propiedad Result devolverá false.If the target declines the offered element during the call, upon return from the call the resulting Task<TResult> will be completed and its Result property will return false. Si el destino pospone el elemento proporcionado, el elemento se almacenará en búfer hasta que el destino lo consuma o lo libere, momento en el que la tarea se completará, y Result indicará si el mensaje se ha consumido.If the target postpones the offered element, the element will be buffered until such time that the target consumes or releases it, at which point the Task will complete, with its Result indicating whether the message was consumed. Si el destino nunca intenta utilizar o lanzar el mensaje, la tarea devuelta nunca se completará.If the target never attempts to consume or release the message, the returned task will never complete.

Si se solicita la cancelación antes de que el destino haya consumido correctamente los datos enviados, la tarea devuelta completará al estado cancelado y datos dejarán de estar disponibles para el destino.If cancellation is requested before the target has successfully consumed the sent data, the returned task will complete in the Canceled state and the data will no longer be available to the target.

Excepciones

target es NULL (Nothing en Visual Basic).The target is null (Nothing in Visual Basic).

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

De forma asincrónica proporciona un mensaje al bloque de mensajes de destino, teniendo en cuenta el aplazamiento.Asynchronously offers a message to the target message block, allowing for postponement.

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 el tipo de los datos que se van a enviar al destino.Specifies the type of the data to post to the target.

Parámetros

target
ITargetBlock<TInput> ITargetBlock<TInput> ITargetBlock<TInput> ITargetBlock<TInput>

El destino en el que se van a exponer los datos.The target to which to post the data.

item
TInput TInput TInput TInput

Elemento que se va a ofrecer al destino.The item being offered to the target.

Devoluciones

Task<TResult> que representa el envío asincrónico.A Task<TResult> that represents the asynchronous send. Si el destino acepta y usa el elemento proporcionado durante la llamada a SendAsync<TInput>(ITargetBlock<TInput>, TInput), al volver de la llamada se completará el Task<TResult> resultante y su propiedad Result devolverá true.If the target accepts and consumes the offered element during the call to SendAsync<TInput>(ITargetBlock<TInput>, TInput), upon return from the call the resulting Task<TResult> will be completed and its Result property will return true. Si el destino rechaza el elemento proporcionado durante la llamada, al volver de la llamada se completará el Task<TResult> resultante y su propiedad Result devolverá false.If the target declines the offered element during the call, upon return from the call the resulting Task<TResult> will be completed and its Result property will return false. Si el destino pospone el elemento proporcionado, el elemento se almacenará en búfer hasta el momento en que el destino lo utilice o lo lance, momento en el que la tarea se completará, con el Result que indica si el mensaje se ha utilizado.If the target postpones the offered element, the element will be buffered until such time that the target consumes or releases it, at which point the task will complete, with its Result indicating whether the message was consumed. Si el destino nunca intenta utilizar o lanzar el mensaje, la tarea devuelta nunca se completará.If the target never attempts to consume or release the message, the returned task will never complete.

Excepciones

Se aplica a