DataflowBlock.SendAsync Metodo

Definizione

Spazio dei nomi:

System.Threading.Tasks.Dataflow

Assembly:

System.Threading.Tasks.Dataflow.dll

Overload

SendAsync<TInput>(ITargetBlock<TInput>, TInput, CancellationToken)	In modo asincrono offre un messaggio al blocco di messaggi di destinazione, consentendo il rinvio.
SendAsync<TInput>(ITargetBlock<TInput>, TInput)	In modo asincrono offre un messaggio al blocco di messaggi di destinazione, consentendo il rinvio.

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

Origine:

DataflowBlock.cs

In modo asincrono offre un messaggio al blocco di messaggi di destinazione, consentendo il rinvio.

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)

Parametri di tipo

TInput

Specifica il tipo di dati da inviare alla destinazione.

Parametri

target

ITargetBlock<TInput>

Destinazione in cui inserire i dati.

item

TInput

L'elemento che viene offerto alla destinazione.

cancellationToken

CancellationToken

Il token di annullamento con cui richiedere l'annullamento dell'operazione di invio.

Restituisce

Task<Boolean>

Oggetto Task<TResult> che rappresenta l'invio asincrono. Se la destinazione accetta e utilizza l'elemento offerto durante la chiamata a SendAsync, al termine della chiamata verrà completata la chiamata Task<TResult> e la relativa Result proprietà restituirà true. Se la destinazione rifiuta l'elemento offerto durante la chiamata, al ritorno dalla chiamata verrà completata la chiamata e Task<TResult> la relativa Result proprietà restituirà false. Se la destinazione rinvia l'elemento offerto, l'elemento verrà memorizzato nel buffer fino a tale momento in cui la destinazione lo utilizza o lo rilascia, a quel punto l'attività verrà completata, con la relativa Result indicazione dell'utilizzo del messaggio. Se la destinazione non tenta di utilizzare o rilasciare il messaggio, l'attività restituita non sarà mai completata.

Se viene richiesto l'annullamento prima che la destinazione abbia finito di utilizzare i dati inviati, l'attività restituita viene completata nello stato di annullamento e i dati e non sono più disponibili alla destinazione.

Eccezioni

ArgumentNullException

Valore target Null (Nothing in Visual Basic).

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

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

Origine:

DataflowBlock.cs

In modo asincrono offre un messaggio al blocco di messaggi di destinazione, consentendo il rinvio.

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)

Parametri di tipo

TInput

Specifica il tipo di dati da inviare alla destinazione.

Parametri

target

ITargetBlock<TInput>

Destinazione in cui inserire i dati.

item

TInput

L'elemento che viene offerto alla destinazione.

Restituisce

Task<Boolean>

Oggetto Task<TResult> che rappresenta l'invio asincrono. Se la destinazione accetta e utilizza l'elemento fornito durante la chiamata a SendAsync<TInput>(ITargetBlock<TInput>, TInput), in risposta alla chiamata l'oggetto Task<TResult> risultante viene completato e la relativa proprietà Result restituisce true. Se la destinazione rifiuta l'elemento fornito durante la chiamata, in risposta alla chiamata l'oggetto Task<TResult> risultante viene completato e la relativa proprietà Result restituisce false. Se la destinazione posticipa l'elemento fornito, l'elemento verrà memorizzato nel buffer fino a quando la destinazione lo utilizzerà o lo rilascerà. A quel punto l'attività sarà completata e il relativo oggetto Result indicherà che il messaggio è stato utilizzato. Se la destinazione non tenta di utilizzare o rilasciare il messaggio, l'attività restituita non sarà mai completata.

Eccezioni

ArgumentNullException

L'elemento target è null.