DataflowBlock.SendAsync Método

Definición

Espacio de nombres:

System.Threading.Tasks.Dataflow

Ensamblado:

System.Threading.Tasks.Dataflow.dll

Paquete:

System.Threading.Tasks.Dataflow v9.0.0-preview.3.24172.9

Sobrecargas

SendAsync<TInput>(ITargetBlock<TInput>, TInput, CancellationToken)	De forma asincrónica proporciona un mensaje al bloque de mensajes de destino, teniendo en cuenta el aplazamiento.
SendAsync<TInput>(ITargetBlock<TInput>, TInput)	De forma asincrónica proporciona un mensaje al bloque de mensajes de destino, teniendo en cuenta el aplazamiento.

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

Source:

DataflowBlock.cs

De forma asincrónica proporciona un mensaje al bloque de mensajes de destino, teniendo en cuenta el aplazamiento.

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 el tipo de los datos que se van a enviar al destino.

Parámetros

target

ITargetBlock<TInput>

El destino en el que se van a exponer los datos.

item

TInput

Elemento que se va a ofrecer al destino.

cancellationToken

CancellationToken

El token de cancelación con el que solicitar la cancelación de la operación de envío.

Devoluciones

Task<Boolean>

Task<TResult> que representa el envío asincrónico. Si el destino acepta y consume el elemento ofrecido durante la llamada a SendAsync, al volver de la llamada, se completará el resultado Task<TResult> y su Result propiedad devolverá true. Si el destino rechaza el elemento ofrecido durante la llamada, al volver de la llamada, se completará el resultado Task<TResult> y su Result propiedad devolverá false. Si el destino pospone el elemento ofrecido, el elemento se almacenará en búfer hasta ese momento en que el destino lo consume o lo libera, momento en el que se completará la tarea, con su Result indicación de si se consumió el mensaje. Si el destino nunca intenta utilizar o lanzar el mensaje, la tarea devuelta nunca se completará.

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.

Excepciones

ArgumentNullException

target es null (Nothing en Visual Basic).

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

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

Source:

DataflowBlock.cs

De forma asincrónica proporciona un mensaje al bloque de mensajes de destino, teniendo en cuenta el aplazamiento.

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.

Parámetros

target

ITargetBlock<TInput>

El destino en el que se van a exponer los datos.

item

TInput

Elemento que se va a ofrecer al destino.

Devoluciones

Task<Boolean>

Task<TResult> que representa el envío asincrónico. 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. 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. 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. Si el destino nunca intenta utilizar o lanzar el mensaje, la tarea devuelta nunca se completará.

Excepciones

ArgumentNullException

El valor de target es null.