DataflowBlock.ReceiveAsync Metodo

Definizione

Spazio dei nomi:

System.Threading.Tasks.Dataflow

Assembly:

System.Threading.Tasks.Dataflow.dll

Pacchetto:

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

Overload

ReceiveAsync<TOutput>(ISourceBlock<TOutput>)	Riceve un valore in modo asincrono 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>)

Origine:

DataflowBlock.cs

Riceve un valore in modo asincrono 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 contenuto nell’origine dati.

Parametri

source

ISourceBlock<TOutput>

Origine dalla quale ricevere il valore.

Restituisce

Task<TOutput>

Attività che rappresenta l'operazione di ricezione asincrona. Quando il valore di un elemento viene ricevuto correttamente dal database di origine, l'attività restituita viene completata e la relativa Result restituisce il valore ricevuto. Se un valore di elemento non può essere recuperato perché l'origine è vuota o completata, viene generata un'eccezione InvalidOperationException nell'attività restituita.

Eccezioni

ArgumentNullException

source è null.

ReceiveAsync<TOutput>(ISourceBlock<TOutput>, CancellationToken)

Origine:

DataflowBlock.cs

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 dalla quale ricevere il valore.

cancellationToken

CancellationToken

Token da utilizzare per annullare l'operazione di ricezione.

Restituisce

Task<TOutput>

Attività che rappresenta l'operazione di ricezione asincrona. Quando un valore viene ricevuto correttamente dal database di origine, l'attività restituita viene completata e la relativa Result restituisce il valore. Se un valore non può essere recuperato 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

ArgumentNullException

source è null.

OperationCanceledException

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

ReceiveAsync<TOutput>(ISourceBlock<TOutput>, TimeSpan)

Origine:

DataflowBlock.cs

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 contenuto nell’origine dati.

Parametri

source

ISourceBlock<TOutput>

Origine dalla quale ricevere il valore.

timeout

TimeSpan

Intervallo di tempo massimo, in millisecondi, in cui attendere il completamento dell'operazione sincrona, o un intervallo che rappresenta -1 millisecondi di attesa indefinita.

Restituisce

Task<TOutput>

Attività che rappresenta l'operazione di ricezione asincrona. Quando un valore viene ricevuto correttamente dal database di origine, l'attività restituita viene completata e la relativa Result restituisce il valore. Se un valore non può essere recuperato 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

ArgumentNullException

source è null.

ArgumentOutOfRangeException

timeout è un numero negativo diverso da -1 millisecondi che rappresenta un timeout infinito.

-oppure-

timeout è maggiore di Int32.MaxValue.

ReceiveAsync<TOutput>(ISourceBlock<TOutput>, TimeSpan, CancellationToken)

Origine:

DataflowBlock.cs

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 contenuto nell’origine dati.

Parametri

source

ISourceBlock<TOutput>

Origine dalla quale ricevere il valore.

timeout

TimeSpan

Intervallo di tempo massimo, in millisecondi, in cui attendere il completamento dell'operazione sincrona, o un intervallo che rappresenta -1 millisecondi di attesa indefinita.

cancellationToken

CancellationToken

Token che può essere utilizzato per annullare l'operazione di ricezione.

Restituisce

Task<TOutput>

Attività che rappresenta l'operazione di ricezione asincrona. Quando un valore viene ricevuto correttamente dal database di origine, l'attività restituita viene completata e la relativa Result restituisce il valore. Se un valore non può essere recuperato perché è scaduto il timeout o è stato richiesto l'annullamento, l'attività restituita viene annullata. Se il valore non può essere recuperato perché l'origine è vuota o completata, viene generata un'eccezione InvalidOperationException nell'attività restituita.

Eccezioni

ArgumentNullException

source è null.

ArgumentOutOfRangeException

timeout è un numero negativo diverso da -1 millisecondi che rappresenta un timeout infinito.

-oppure-

timeout è maggiore di Int32.MaxValue.

OperationCanceledException

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