DataflowBlock.SendAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
- Source:
- DataflowBlock.cs
- 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<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
target
es null (Nothing en Visual Basic).
Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.
Se aplica a
SendAsync<TInput>(ITargetBlock<TInput>, TInput)
- Source:
- DataflowBlock.cs
- Source:
- DataflowBlock.cs
- 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<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
El valor de target
es null
.