DataflowBlock.Receive Methode

Definition

Namespace:

System.Threading.Tasks.Dataflow

Assembly:

System.Threading.Tasks.Dataflow.dll

Paket:

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

Überlädt

Receive<TOutput>(ISourceBlock<TOutput>)	Empfängt synchron einen Wert aus der angegebenen Quelle.
Receive<TOutput>(ISourceBlock<TOutput>, CancellationToken)	Erhält synchron einen Wert aus einer angegebenen Quelle und stellt ein Token bereit, um die Operation abzubrechen.
Receive<TOutput>(ISourceBlock<TOutput>, TimeSpan)	Empfängt synchron einen Wert aus einer angegebenen Quelle und beachtet ein optionales Timeout.
Receive<TOutput>(ISourceBlock<TOutput>, TimeSpan, CancellationToken)	Empfängt synchron einen Wert aus einer angegebenen Quelle, stellt ein Token bereit, um den Vorgang abzubrechen und beachtet ein optionales Timeoutintervall.

Receive<TOutput>(ISourceBlock<TOutput>)

Quelle:

DataflowBlock.cs

Empfängt synchron einen Wert aus der angegebenen Quelle.

public:
generic <typename TOutput>
[System::Runtime::CompilerServices::Extension]
 static TOutput Receive(System::Threading::Tasks::Dataflow::ISourceBlock<TOutput> ^ source);

public static TOutput Receive<TOutput> (this System.Threading.Tasks.Dataflow.ISourceBlock<TOutput> source);

static member Receive : System.Threading.Tasks.Dataflow.ISourceBlock<'Output> -> 'Output

<Extension()>
Public Function Receive(Of TOutput) (source As ISourceBlock(Of TOutput)) As TOutput

Typparameter

TOutput

Der Datentyp, der in der Datenquelle enthalten ist.

Parameter

source

ISourceBlock<TOutput>

Die Quelle, aus der der Wert empfangen werden soll.

Gibt zurück

TOutput

Der empfangene Wert.

Ausnahmen

ArgumentNullException

source ist null.

InvalidOperationException

Kein Element konnte von der Quelle empfangen werden.

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

Quelle:

DataflowBlock.cs

Erhält synchron einen Wert aus einer angegebenen Quelle und stellt ein Token bereit, um die Operation abzubrechen.

public:
generic <typename TOutput>
[System::Runtime::CompilerServices::Extension]
 static TOutput Receive(System::Threading::Tasks::Dataflow::ISourceBlock<TOutput> ^ source, System::Threading::CancellationToken cancellationToken);

public static TOutput Receive<TOutput> (this System.Threading.Tasks.Dataflow.ISourceBlock<TOutput> source, System.Threading.CancellationToken cancellationToken);

static member Receive : System.Threading.Tasks.Dataflow.ISourceBlock<'Output> * System.Threading.CancellationToken -> 'Output

<Extension()>
Public Function Receive(Of TOutput) (source As ISourceBlock(Of TOutput), cancellationToken As CancellationToken) As TOutput

Typparameter

TOutput

Der Datentyp, der in der Datenquelle enthalten ist.

Parameter

source

ISourceBlock<TOutput>

Die Quelle, aus der der Wert empfangen werden soll.

cancellationToken

CancellationToken

Das Token, das verwendet wird, um den Empfangsvorgang abzubrechen.

Gibt zurück

TOutput

Der empfangene Wert.

Ausnahmen

ArgumentNullException

source ist null.

InvalidOperationException

Kein Element konnte von der Quelle empfangen werden.

OperationCanceledException

Der Vorgang wurde abgebrochen, bevor ein Element aus der Quelle empfangen wurde.

Hinweise

Wenn die Quelle erfolgreich ein Element angeboten hat, das von diesem Vorgang empfangen wurde, wird dieses Element zurückgegeben, auch wenn eine gleichzeitige Abbruchanforderung auftritt.

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

Quelle:

DataflowBlock.cs

Empfängt synchron einen Wert aus einer angegebenen Quelle und beachtet ein optionales Timeout.

public:
generic <typename TOutput>
[System::Runtime::CompilerServices::Extension]
 static TOutput Receive(System::Threading::Tasks::Dataflow::ISourceBlock<TOutput> ^ source, TimeSpan timeout);

public static TOutput Receive<TOutput> (this System.Threading.Tasks.Dataflow.ISourceBlock<TOutput> source, TimeSpan timeout);

static member Receive : System.Threading.Tasks.Dataflow.ISourceBlock<'Output> * TimeSpan -> 'Output

<Extension()>
Public Function Receive(Of TOutput) (source As ISourceBlock(Of TOutput), timeout As TimeSpan) As TOutput

Typparameter

TOutput

Der Datentyp, der in der Datenquelle enthalten ist.

Parameter

source

ISourceBlock<TOutput>

Die Quelle, aus der der Wert empfangen werden soll.

timeout

TimeSpan

Das maximale Zeitintervall, in Millisekunden, der gewartet werden muss, bis der synchrone Vorgang abgeschlossen wurde, oder auf ein Intervall, der -1 Millisekunden darstellt, um unbegrenzt zu warten.

Gibt zurück

TOutput

Der empfangene Wert.

Ausnahmen

ArgumentOutOfRangeException

timeout ist eine negative Zahl, aber nicht -1 Millisekunde. Ein Wert von -1 Millisekunde gibt eine Endlostimeoutperiode an.

- oder -

timeout ist größer als Int32.MaxValue.

ArgumentNullException

source ist null.

InvalidOperationException

Kein Element konnte von der Quelle empfangen werden.

TimeoutException

Das angegebene Timeout ist abgelaufen, bevor ein Element von der Quelle empfangen wurde.

Hinweise

Wenn die Quelle erfolgreich ein Element angeboten hat, das von diesem Vorgang empfangen wurde, wird dieses Element zurückgegeben, auch wenn ein gleichzeitiges Timeout auftritt.

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

Quelle:

DataflowBlock.cs

Empfängt synchron einen Wert aus einer angegebenen Quelle, stellt ein Token bereit, um den Vorgang abzubrechen und beachtet ein optionales Timeoutintervall.

public:
generic <typename TOutput>
[System::Runtime::CompilerServices::Extension]
 static TOutput Receive(System::Threading::Tasks::Dataflow::ISourceBlock<TOutput> ^ source, TimeSpan timeout, System::Threading::CancellationToken cancellationToken);

public static TOutput Receive<TOutput> (this System.Threading.Tasks.Dataflow.ISourceBlock<TOutput> source, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

static member Receive : System.Threading.Tasks.Dataflow.ISourceBlock<'Output> * TimeSpan * System.Threading.CancellationToken -> 'Output

<Extension()>
Public Function Receive(Of TOutput) (source As ISourceBlock(Of TOutput), timeout As TimeSpan, cancellationToken As CancellationToken) As TOutput

Typparameter

TOutput

Der Datentyp, der in der Datenquelle enthalten ist.

Parameter

source

ISourceBlock<TOutput>

Die Quelle, aus der der Wert empfangen werden soll.

timeout

TimeSpan

Das maximale Zeitintervall, in Millisekunden, der gewartet werden muss, bis der synchrone Vorgang abgeschlossen wurde, oder auf ein Intervall, der -1 Millisekunden darstellt, um unbegrenzt zu warten.

cancellationToken

CancellationToken

Das Token, das verwendet wird, um den Empfangsvorgang abzubrechen.

Gibt zurück

TOutput

Der empfangene Wert.

Ausnahmen

ArgumentNullException

source ist null.

ArgumentOutOfRangeException

timeout ist eine negative Zahl, aber nicht -1 Millisekunde. Ein Wert von -1 Millisekunde gibt eine Endlostimeoutperiode an.

- oder -

timeout ist größer als Int32.MaxValue.

InvalidOperationException

Kein Element konnte von der Quelle empfangen werden.

TimeoutException

Das angegebene Timeout ist abgelaufen, bevor ein Element von der Quelle empfangen wurde.

OperationCanceledException

Der Vorgang wurde abgebrochen, bevor ein Element aus der Quelle empfangen wurde.

Hinweise

Wenn die Quelle erfolgreich einen Elementwert angeboten hat, der von diesem Vorgang empfangen wurde, wird dieser Wert zurückgegeben, auch wenn eine gleichzeitige Timeout- oder Abbruchanforderung auftritt.