DataflowBlock.ReceiveAsync 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 |
|---|---|
| ReceiveAsync<TOutput>(ISourceBlock<TOutput>) |
Riceve in modo asincrono un valore da un'origine specificata. |
| ReceiveAsync<TOutput>(ISourceBlock<TOutput>, CancellationToken) |
Riceve in modo asincrono un valore da un'origine specificata e fornisce un token per annullare l'operazione. |
| ReceiveAsync<TOutput>(ISourceBlock<TOutput>, TimeSpan) |
Riceve in modo asincrono un valore da un'origine specificata, osservando un periodo di timeout facoltativo. |
| ReceiveAsync<TOutput>(ISourceBlock<TOutput>, TimeSpan, CancellationToken) |
Riceve in modo asincrono un valore da un'origine specificata, fornendo un token per annullare l'operazione e osservando un intervallo di timeout facoltativo. |
ReceiveAsync<TOutput>(ISourceBlock<TOutput>)
Riceve in modo asincrono un valore da un'origine specificata.
public:
generic <typename TOutput>
[System::Runtime::CompilerServices::Extension]
static System::Threading::Tasks::Task<TOutput> ^ ReceiveAsync(System::Threading::Tasks::Dataflow::ISourceBlock<TOutput> ^ source);public static System.Threading.Tasks.Task<TOutput> ReceiveAsync<TOutput>(this System.Threading.Tasks.Dataflow.ISourceBlock<TOutput> source);static member ReceiveAsync : System.Threading.Tasks.Dataflow.ISourceBlock<'Output> -> System.Threading.Tasks.Task<'Output><Extension()>
Public Function ReceiveAsync(Of TOutput) (source As ISourceBlock(Of TOutput)) As Task(Of TOutput)Parametri di tipo
- TOutput
Tipo di dati contenuti nell'origine.
Parametri
- source
- ISourceBlock<TOutput>
Origine da cui ricevere il valore.
Valori restituiti
Attività che rappresenta l'operazione di ricezione asincrona. Quando un valore dell'elemento viene ricevuto correttamente dall'origine, l'attività restituita viene completata e restituisce Result il valore ricevuto. Se non è possibile recuperare un valore di elemento perché l'origine è vuota e completata, viene generata un'eccezione InvalidOperationException nell'attività restituita.
Eccezioni
source è null.
Si applica a
ReceiveAsync<TOutput>(ISourceBlock<TOutput>, CancellationToken)
Riceve in modo asincrono un valore da un'origine specificata e fornisce un token per annullare l'operazione.
public:
generic <typename TOutput>
[System::Runtime::CompilerServices::Extension]
static System::Threading::Tasks::Task<TOutput> ^ ReceiveAsync(System::Threading::Tasks::Dataflow::ISourceBlock<TOutput> ^ source, System::Threading::CancellationToken cancellationToken);public static System.Threading.Tasks.Task<TOutput> ReceiveAsync<TOutput>(this System.Threading.Tasks.Dataflow.ISourceBlock<TOutput> source, System.Threading.CancellationToken cancellationToken);static member ReceiveAsync : System.Threading.Tasks.Dataflow.ISourceBlock<'Output> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Output><Extension()>
Public Function ReceiveAsync(Of TOutput) (source As ISourceBlock(Of TOutput), cancellationToken As CancellationToken) As Task(Of TOutput)Parametri di tipo
- TOutput
Specifica il tipo di dati contenuti nell'origine.
Parametri
- source
- ISourceBlock<TOutput>
Origine da cui ricevere il valore.
- cancellationToken
- CancellationToken
Token da usare per annullare l'operazione di ricezione.
Valori restituiti
Attività che rappresenta l'operazione di ricezione asincrona. Quando un valore viene ricevuto correttamente dall'origine, l'attività restituita viene completata e restituisce Result il valore . Se non è possibile recuperare un valore perché è stato richiesto l'annullamento, l'attività restituita viene annullata. Se il valore non può essere recuperato perché l'origine è vuota e completata , viene generata un'eccezione InvalidOperationException nell'attività restituita.
Eccezioni
source è null.
Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.
Si applica a
ReceiveAsync<TOutput>(ISourceBlock<TOutput>, TimeSpan)
Riceve in modo asincrono un valore da un'origine specificata, osservando un periodo di timeout facoltativo.
public:
generic <typename TOutput>
[System::Runtime::CompilerServices::Extension]
static System::Threading::Tasks::Task<TOutput> ^ ReceiveAsync(System::Threading::Tasks::Dataflow::ISourceBlock<TOutput> ^ source, TimeSpan timeout);public static System.Threading.Tasks.Task<TOutput> ReceiveAsync<TOutput>(this System.Threading.Tasks.Dataflow.ISourceBlock<TOutput> source, TimeSpan timeout);static member ReceiveAsync : System.Threading.Tasks.Dataflow.ISourceBlock<'Output> * TimeSpan -> System.Threading.Tasks.Task<'Output><Extension()>
Public Function ReceiveAsync(Of TOutput) (source As ISourceBlock(Of TOutput), timeout As TimeSpan) As Task(Of TOutput)Parametri di tipo
- TOutput
Tipo di dati contenuti nell'origine.
Parametri
- source
- ISourceBlock<TOutput>
Origine da cui ricevere il valore.
- timeout
- TimeSpan
Intervallo di tempo massimo, in millisecondi, per attendere il completamento dell'operazione sincrona o un intervallo che rappresenta -1 millisecondi di attesa illimitata.
Valori restituiti
Attività che rappresenta l'operazione di ricezione asincrona. Quando un valore viene ricevuto correttamente dall'origine, l'attività restituita viene completata e restituisce Result il valore . Se non è possibile recuperare un valore perché il timeout è scaduto, l'attività restituita viene annullata. Se il valore non può essere recuperato perché l'origine è vuota e completata , viene generata un'eccezione InvalidOperationException nell'attività restituita.
Eccezioni
source è null.
timeout è un numero negativo diverso da -1 millisecondi, che rappresenta un periodo di timeout infinito.
oppure
timeout è maggiore di Int32.MaxValue.
Si applica a
ReceiveAsync<TOutput>(ISourceBlock<TOutput>, TimeSpan, CancellationToken)
Riceve in modo asincrono un valore da un'origine specificata, fornendo un token per annullare l'operazione e osservando un intervallo di timeout facoltativo.
public:
generic <typename TOutput>
[System::Runtime::CompilerServices::Extension]
static System::Threading::Tasks::Task<TOutput> ^ ReceiveAsync(System::Threading::Tasks::Dataflow::ISourceBlock<TOutput> ^ source, TimeSpan timeout, System::Threading::CancellationToken cancellationToken);public static System.Threading.Tasks.Task<TOutput> ReceiveAsync<TOutput>(this System.Threading.Tasks.Dataflow.ISourceBlock<TOutput> source, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);static member ReceiveAsync : System.Threading.Tasks.Dataflow.ISourceBlock<'Output> * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Output><Extension()>
Public Function ReceiveAsync(Of TOutput) (source As ISourceBlock(Of TOutput), timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of TOutput)Parametri di tipo
- TOutput
Tipo di dati contenuti nell'origine.
Parametri
- source
- ISourceBlock<TOutput>
Origine da cui ricevere il valore.
- timeout
- TimeSpan
Intervallo di tempo massimo, in millisecondi, per attendere il completamento dell'operazione sincrona o un intervallo che rappresenta -1 millisecondi di attesa illimitata.
- cancellationToken
- CancellationToken
Token che può essere usato per annullare l'operazione di ricezione.
Valori restituiti
Attività che rappresenta l'operazione di ricezione asincrona. Quando un valore viene ricevuto correttamente dall'origine, l'attività restituita viene completata e restituisce Result il valore . Se non è possibile recuperare un valore perché è stato richiesto il timeout scaduto o l'annullamento, l'attività restituita viene annullata. Se il valore non può essere recuperato perché l'origine è vuota e completata, viene generata un'eccezione InvalidOperationException nell'attività restituita.
Eccezioni
source è null.
timeout è un numero negativo diverso da -1 millisecondi, che rappresenta un periodo di timeout infinito.
oppure
timeout è maggiore di Int32.MaxValue.
Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.