DataflowBlock.Receive Metoda

Definicja

Przestrzeń nazw:

System.Threading.Tasks.Dataflow

Zestaw:

System.Threading.Tasks.Dataflow.dll

Pakiet:

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

Przeciążenia

Receive<TOutput>(ISourceBlock<TOutput>)	Synchronicznie odbiera wartość z określonego źródła.
Receive<TOutput>(ISourceBlock<TOutput>, CancellationToken)	Synchronicznie odbiera wartość z określonego źródła i udostępnia token umożliwiający anulowanie operacji.
Receive<TOutput>(ISourceBlock<TOutput>, TimeSpan)	Synchronicznie odbiera wartość z określonego źródła, obserwując opcjonalny okres limitu czasu.
Receive<TOutput>(ISourceBlock<TOutput>, TimeSpan, CancellationToken)	Synchronicznie odbiera wartość z określonego źródła, zapewniając token umożliwiający anulowanie operacji i obserwowanie opcjonalnego interwału limitu czasu.

Receive<TOutput>(ISourceBlock<TOutput>)

Źródło:

DataflowBlock.cs

Synchronicznie odbiera wartość z określonego źródła.

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

Parametry typu

TOutput

Typ danych zawartych w źródle.

Parametry

source

ISourceBlock<TOutput>

Źródło, z którego ma zostać odebrana wartość.

Zwraca

TOutput

Odebrana wartość.

Wyjątki

ArgumentNullException

source to null.

InvalidOperationException

Nie można odebrać elementu ze źródła.

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

Źródło:

DataflowBlock.cs

Synchronicznie odbiera wartość z określonego źródła i udostępnia token umożliwiający anulowanie operacji.

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

Parametry typu

TOutput

Typ danych zawartych w źródle.

Parametry

source

ISourceBlock<TOutput>

Źródło, z którego ma zostać odebrana wartość.

cancellationToken

CancellationToken

Token używany do anulowania operacji odbierania.

Zwraca

TOutput

Odebrana wartość.

Wyjątki

ArgumentNullException

source to null.

InvalidOperationException

Nie można odebrać elementu ze źródła.

OperationCanceledException

Operacja została anulowana przed odebraniem elementu ze źródła.

Uwagi

Jeśli źródło pomyślnie zaoferowało element, który został odebrany przez tę operację, ten element jest zwracany nawet wtedy, gdy wystąpi jednoczesne żądanie anulowania.

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

Źródło:

DataflowBlock.cs

Synchronicznie odbiera wartość z określonego źródła, obserwując opcjonalny okres limitu czasu.

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

Parametry typu

TOutput

Typ danych zawartych w źródle.

Parametry

source

ISourceBlock<TOutput>

Źródło, z którego ma zostać odebrana wartość.

timeout

TimeSpan

Maksymalny interwał czasu (w milisekundach) oczekiwania na ukończenie operacji synchronicznej lub interwał reprezentujący -1 milisekundy oczekiwania na czas nieokreślony.

Zwraca

TOutput

Odebrana wartość.

Wyjątki

ArgumentOutOfRangeException

timeout jest liczbą ujemną inną niż -1 milisekundy, która reprezentuje nieskończony limit czasu.

-lub-

timeout parametr jest większy niż Int32.MaxValue.

ArgumentNullException

source to null.

InvalidOperationException

Nie można odebrać elementu ze źródła.

TimeoutException

Określony limit czasu wygasł przed odebraniem elementu ze źródła.

Uwagi

Jeśli źródło pomyślnie zaoferowało element, który został odebrany przez tę operację, ten element jest zwracany nawet wtedy, gdy wystąpi współbieżny limit czasu.

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

Źródło:

DataflowBlock.cs

Synchronicznie odbiera wartość z określonego źródła, zapewniając token umożliwiający anulowanie operacji i obserwowanie opcjonalnego interwału limitu czasu.

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

Parametry typu

TOutput

Typ danych zawartych w źródle.

Parametry

source

ISourceBlock<TOutput>

Źródło, z którego ma zostać odebrana wartość.

timeout

TimeSpan

Maksymalny interwał czasu (w milisekundach) oczekiwania na ukończenie operacji synchronicznej lub interwał reprezentujący -1 milisekundy oczekiwania na czas nieokreślony.

cancellationToken

CancellationToken

Token używany do anulowania operacji odbierania.

Zwraca

TOutput

Odebrana wartość.

Wyjątki

ArgumentNullException

Wartość source to null.

ArgumentOutOfRangeException

timeout jest liczbą ujemną inną niż -1 milisekundy, która reprezentuje nieskończony limit czasu.

-lub-

timeout parametr jest większy niż Int32.MaxValue.

InvalidOperationException

Nie można odebrać elementu ze źródła.

TimeoutException

Określony limit czasu wygasł przed odebraniem elementu ze źródła.

OperationCanceledException

Operacja została anulowana przed odebraniem elementu ze źródła.

Uwagi

Jeśli źródło pomyślnie zaoferowało wartość elementu, która została odebrana przez tę operację, ta wartość jest zwracana nawet wtedy, gdy wystąpi równoczesny limit czasu lub żądanie anulowania.