DataflowBlock.Receive 方法

參考

定義

命名空間:: System.Threading.Tasks.Dataflow

組件:: System.Threading.Tasks.Dataflow.dll

套件:: System.Threading.Tasks.Dataflow v8.0.0

套件:: System.Threading.Tasks.Dataflow v9.0.0-preview.3.24172.9

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

Receive<TOutput>(ISourceBlock<TOutput>)	以同步方式接收來自指定之來源的值。
Receive<TOutput>(ISourceBlock<TOutput>, CancellationToken)	同步接收指定之來源的值，並提供語彙基元取消作業。
Receive<TOutput>(ISourceBlock<TOutput>, TimeSpan)	同步接收指定之來源的值，觀察選擇性逾時期限。
Receive<TOutput>(ISourceBlock<TOutput>, TimeSpan, CancellationToken)	同步接收指定之來源的值，提供語彙基元取消作業並觀察選擇性逾時間隔。

Receive<TOutput>(ISourceBlock<TOutput>)

來源:: DataflowBlock.cs

來源:: DataflowBlock.cs

來源:: DataflowBlock.cs

以同步方式接收來自指定之來源的值。

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

類型參數

TOutput

來源中包含的資料類型。

參數

source: ISourceBlock<TOutput>

要從其中接收值的來源。

傳回

TOutput

接收到的值。

例外狀況

ArgumentNullException

source 為 null。

InvalidOperationException

無法從來源接收項目。

適用於

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

來源:: DataflowBlock.cs

來源:: DataflowBlock.cs

來源:: DataflowBlock.cs

同步接收指定之來源的值，並提供語彙基元取消作業。

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

類型參數

TOutput

來源中包含的資料類型。

參數

source: ISourceBlock<TOutput>

要從其中接收值的來源。

cancellationToken: CancellationToken

要用來取消接收作業的語彙基元。

傳回

TOutput

接收到的值。

例外狀況

ArgumentNullException

source 為 null。

InvalidOperationException

無法從來源接收項目。

OperationCanceledException

從來源收到項目之前，已取消作業。

備註

如果來源已成功提供此作業所接收的專案，即使發生並行取消要求，也會傳回該專案。

適用於

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

來源:: DataflowBlock.cs

來源:: DataflowBlock.cs

來源:: DataflowBlock.cs

同步接收指定之來源的值，觀察選擇性逾時期限。

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

類型參數

TOutput

來源中包含的資料類型。

參數

source: ISourceBlock<TOutput>

要從其中接收值的來源。

timeout: TimeSpan

等待同步作業完成的最大時間間隔 (以毫秒為單位)，或者以 -1 表示無限期等候的時間間隔。

傳回

TOutput

接收到的值。

例外狀況

ArgumentOutOfRangeException

timeout 是一個不等於 -1 的負數，這表示無限的逾時時間。

-或-

timeout 大於 Int32.MaxValue。

ArgumentNullException

source 為 null。

InvalidOperationException

無法從來源接收項目。

TimeoutException

指定的逾時在從來源接收項目之前到期。

備註

如果來源已成功提供這項作業所接收的專案，即使發生並行逾時，也會傳回該專案。

適用於

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

來源:: DataflowBlock.cs

來源:: DataflowBlock.cs

來源:: DataflowBlock.cs

同步接收指定之來源的值，提供語彙基元取消作業並觀察選擇性逾時間隔。

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

類型參數

TOutput

來源中包含的資料類型。

參數

source: ISourceBlock<TOutput>

要從其中接收值的來源。

timeout: TimeSpan

等待同步作業完成的最大時間間隔 (以毫秒為單位)，或者以 -1 表示無限期等候的時間間隔。

cancellationToken: CancellationToken

要用來取消接收作業的語彙基元。

傳回

TOutput

接收到的值。

例外狀況

ArgumentNullException

source 為 null。

ArgumentOutOfRangeException

timeout 是一個不等於 -1 的負數，這表示無限的逾時時間。

-或-

timeout 大於 Int32.MaxValue。

InvalidOperationException

無法從來源接收項目。

TimeoutException

指定的逾時在從來源接收項目之前到期。

OperationCanceledException

從來源收到項目之前，已取消作業。

備註

如果來源已成功提供此作業所收到的專案值，即使發生並行逾時或取消要求，也會傳回該值。

適用於

DataflowBlock.Receive 方法

定義

多載

Receive<TOutput>(ISourceBlock<TOutput>)

類型參數

參數

傳回

例外狀況

適用於

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

類型參數

參數

傳回

例外狀況

備註

適用於

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

類型參數

參數

傳回

例外狀況

備註

適用於

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

類型參數

參數

傳回

例外狀況

備註

適用於

意見反應

其他資源