DataflowBlock.ReceiveAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| Name | Beschreibung |
|---|---|
| ReceiveAsync<TOutput>(ISourceBlock<TOutput>) |
Empfängt asynchron einen Wert aus einer angegebenen Quelle. |
| ReceiveAsync<TOutput>(ISourceBlock<TOutput>, CancellationToken) |
Empfängt asynchron einen Wert aus einer angegebenen Quelle und stellt ein Token zum Abbrechen des Vorgangs bereit. |
| ReceiveAsync<TOutput>(ISourceBlock<TOutput>, TimeSpan) |
Empfängt asynchron einen Wert aus einer angegebenen Quelle, wobei ein optionaler Timeoutzeitraum beobachtet wird. |
| ReceiveAsync<TOutput>(ISourceBlock<TOutput>, TimeSpan, CancellationToken) |
Empfängt asynchron einen Wert aus einer angegebenen Quelle und stellt ein Token bereit, um den Vorgang abzubrechen und ein optionales Timeoutintervall zu beobachten. |
ReceiveAsync<TOutput>(ISourceBlock<TOutput>)
Empfängt asynchron einen Wert aus einer angegebenen Quelle.
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)Typparameter
- TOutput
Der Datentyp, der in der Quelle enthalten ist.
Parameter
- source
- ISourceBlock<TOutput>
Die Quelle, von der der Wert empfangen werden soll.
Gibt zurück
Eine Aufgabe, die den asynchronen Empfangsvorgang darstellt. Wenn ein Elementwert erfolgreich von der Quelle empfangen wird, wird der zurückgegebene Vorgang abgeschlossen und Result der empfangene Wert zurückgegeben. Wenn ein Elementwert nicht abgerufen werden kann, da die Quelle leer und abgeschlossen ist, wird eine InvalidOperationException Ausnahme in der zurückgegebenen Aufgabe ausgelöst.
Ausnahmen
source ist null.
Gilt für:
ReceiveAsync<TOutput>(ISourceBlock<TOutput>, CancellationToken)
Empfängt asynchron einen Wert aus einer angegebenen Quelle und stellt ein Token zum Abbrechen des Vorgangs bereit.
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)Typparameter
- TOutput
Gibt den Datentyp an, der in der Quelle enthalten ist.
Parameter
- source
- ISourceBlock<TOutput>
Die Quelle, von der der Wert empfangen werden soll.
- cancellationToken
- CancellationToken
Das Token, das zum Abbrechen des Empfangsvorgangs verwendet werden soll.
Gibt zurück
Eine Aufgabe, die den asynchronen Empfangsvorgang darstellt. Wenn ein Wert erfolgreich von der Quelle empfangen wird, wird die zurückgegebene Aufgabe abgeschlossen und gibt Result den Wert zurück. Wenn ein Wert nicht abgerufen werden kann, weil ein Abbruch angefordert wurde, wird die zurückgegebene Aufgabe abgebrochen. Wenn der Wert nicht abgerufen werden kann, da die Quelle leer und abgeschlossen ist, wird eine InvalidOperationException Ausnahme in der zurückgegebenen Aufgabe ausgelöst.
Ausnahmen
source ist null.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Gilt für:
ReceiveAsync<TOutput>(ISourceBlock<TOutput>, TimeSpan)
Empfängt asynchron einen Wert aus einer angegebenen Quelle, wobei ein optionaler Timeoutzeitraum beobachtet wird.
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)Typparameter
- TOutput
Der Datentyp, der in der Quelle enthalten ist.
Parameter
- source
- ISourceBlock<TOutput>
Die Quelle, von der der Wert empfangen werden soll.
- timeout
- TimeSpan
Das maximale Zeitintervall in Millisekunden, um zu warten, bis der synchrone Vorgang abgeschlossen ist, oder ein Intervall, das -1 Millisekunden darstellt, auf unbestimmte Zeit zu warten.
Gibt zurück
Eine Aufgabe, die den asynchronen Empfangsvorgang darstellt. Wenn ein Wert erfolgreich von der Quelle empfangen wird, wird die zurückgegebene Aufgabe abgeschlossen und gibt Result den Wert zurück. Wenn ein Wert nicht abgerufen werden kann, da das Timeout abgelaufen ist, wird die zurückgegebene Aufgabe abgebrochen. Wenn der Wert nicht abgerufen werden kann, da die Quelle leer und abgeschlossen ist, wird eine InvalidOperationException Ausnahme in der zurückgegebenen Aufgabe ausgelöst.
Ausnahmen
source ist null.
timeout ist eine andere negative Zahl als -1 Millisekunden, die einen unendlichen Timeoutzeitraum darstellt.
-oder-
timeout ist größer als Int32.MaxValue.
Gilt für:
ReceiveAsync<TOutput>(ISourceBlock<TOutput>, TimeSpan, CancellationToken)
Empfängt asynchron einen Wert aus einer angegebenen Quelle und stellt ein Token bereit, um den Vorgang abzubrechen und ein optionales Timeoutintervall zu beobachten.
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)Typparameter
- TOutput
Der Datentyp, der in der Quelle enthalten ist.
Parameter
- source
- ISourceBlock<TOutput>
Die Quelle, von der der Wert empfangen werden soll.
- timeout
- TimeSpan
Das maximale Zeitintervall in Millisekunden, um zu warten, bis der synchrone Vorgang abgeschlossen ist, oder ein Intervall, das -1 Millisekunden darstellt, auf unbestimmte Zeit zu warten.
- cancellationToken
- CancellationToken
Das Token, das zum Abbrechen des Empfangsvorgangs verwendet werden kann.
Gibt zurück
Eine Aufgabe, die den asynchronen Empfangsvorgang darstellt. Wenn ein Wert erfolgreich von der Quelle empfangen wird, wird die zurückgegebene Aufgabe abgeschlossen und gibt Result den Wert zurück. Wenn ein Wert nicht abgerufen werden kann, weil das Timeout abgelaufen oder abgesagt wurde, wird die zurückgegebene Aufgabe abgebrochen. Wenn der Wert nicht abgerufen werden kann, da die Quelle leer und abgeschlossen ist, wird eine InvalidOperationException Ausnahme in der zurückgegebenen Aufgabe ausgelöst.
Ausnahmen
source ist null.
timeout ist eine andere negative Zahl als -1 Millisekunden, die einen unendlichen Timeoutzeitraum darstellt.
-oder-
timeout ist größer als Int32.MaxValue.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.