DataflowBlock.SendAsync Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
| Nome | Descrizione |
|---|---|
| SendAsync<TInput>(ITargetBlock<TInput>, TInput, CancellationToken) |
Offre in modo asincrono un messaggio al blocco di messaggi di destinazione, consentendo il posticipo. |
| SendAsync<TInput>(ITargetBlock<TInput>, TInput) |
Offre in modo asincrono un messaggio al blocco di messaggi di destinazione, consentendo il posticipo. |
SendAsync<TInput>(ITargetBlock<TInput>, TInput, CancellationToken)
- Origine:
- DataflowBlock.cs
- Origine:
- DataflowBlock.cs
- Origine:
- DataflowBlock.cs
- Origine:
- DataflowBlock.cs
- Origine:
- DataflowBlock.cs
- Origine:
- DataflowBlock.cs
- Origine:
- DataflowBlock.cs
Offre in modo asincrono un messaggio al blocco di messaggi di destinazione, consentendo il posticipo.
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 inserire nella destinazione.
Parametri
- target
- ITargetBlock<TInput>
Destinazione in cui inserire i dati.
- item
- TInput
Elemento offerto alla destinazione.
- cancellationToken
- CancellationToken
Token di annullamento con cui richiedere l'annullamento dell'operazione di invio.
Valori restituiti
Oggetto Task<TResult> che rappresenta l'invio asincrono. Se la destinazione accetta e utilizza l'elemento offerto durante la chiamata a SendAsync, al ritorno dalla chiamata il risultato Task<TResult> verrà completato e la relativa Result proprietà restituirà true. Se la destinazione rifiuta l'elemento offerto durante la chiamata, al ritorno dalla chiamata l'oggetto risultante Task<TResult> verrà completato e la relativa Result proprietà restituirà false. Se la destinazione posticipa l'elemento offerto, l'elemento verrà memorizzato nel buffer fino al momento in cui la destinazione lo utilizza o lo rilascia, a quel punto l'attività verrà completata, con il relativo Result valore che indica se il messaggio è stato utilizzato. Se la destinazione non tenta mai di utilizzare o rilasciare il messaggio, l'attività restituita non verrà mai completata.
Se l'annullamento viene richiesto prima che la destinazione abbia utilizzato correttamente i dati inviati, l'attività restituita verrà completata nello stato Annullato e i dati non saranno più disponibili per la destinazione.
Eccezioni
Il target è null (Nothing in Visual Basic).
Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.
Si applica a
SendAsync<TInput>(ITargetBlock<TInput>, TInput)
- Origine:
- DataflowBlock.cs
- Origine:
- DataflowBlock.cs
- Origine:
- DataflowBlock.cs
- Origine:
- DataflowBlock.cs
- Origine:
- DataflowBlock.cs
- Origine:
- DataflowBlock.cs
- Origine:
- DataflowBlock.cs
Offre in modo asincrono un messaggio al blocco di messaggi di destinazione, consentendo il posticipo.
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 inserire nella destinazione.
Parametri
- target
- ITargetBlock<TInput>
Destinazione in cui inserire i dati.
- item
- TInput
Elemento offerto alla destinazione.
Valori restituiti
Oggetto Task<TResult> che rappresenta l'invio asincrono. Se la destinazione accetta e utilizza l'elemento offerto durante la chiamata a SendAsync<TInput>(ITargetBlock<TInput>, TInput), al ritorno dalla chiamata il risultato Task<TResult> verrà completato e la relativa Result proprietà restituirà true. Se la destinazione rifiuta l'elemento offerto durante la chiamata, al ritorno dalla chiamata l'oggetto risultante Task<TResult> verrà completato e la relativa Result proprietà restituirà false. Se la destinazione posticipa l'elemento offerto, l'elemento verrà memorizzato nel buffer fino al momento in cui la destinazione lo utilizza o lo rilascia, a quel punto l'attività verrà completata, con il relativo Result valore che indica se il messaggio è stato utilizzato. Se la destinazione non tenta mai di utilizzare o rilasciare il messaggio, l'attività restituita non verrà mai completata.
Eccezioni
Il target è null.