DataflowBlock.Receive 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 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>)
以同步方式接收來自指定之來源的值。
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>
要從其中接收值的來源。
傳回
接收到的值。
例外狀況
source
為 null
。
無法從來源接收項目。
適用於
Receive<TOutput>(ISourceBlock<TOutput>, CancellationToken)
同步接收指定之來源的值,並提供語彙基元取消作業。
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
要用來取消接收作業的語彙基元。
傳回
接收到的值。
例外狀況
source
為 null
。
無法從來源接收項目。
從來源收到項目之前,已取消作業。
備註
如果來源已成功提供此作業所接收的專案,即使發生並行取消要求,也會傳回該專案。
適用於
Receive<TOutput>(ISourceBlock<TOutput>, TimeSpan)
同步接收指定之來源的值,觀察選擇性逾時期限。
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 表示無限期等候的時間間隔。
傳回
接收到的值。
例外狀況
source
為 null
。
無法從來源接收項目。
指定的逾時在從來源接收項目之前到期。
備註
如果來源已成功提供這項作業所接收的專案,即使發生並行逾時,也會傳回該專案。
適用於
Receive<TOutput>(ISourceBlock<TOutput>, TimeSpan, CancellationToken)
同步接收指定之來源的值,提供語彙基元取消作業並觀察選擇性逾時間隔。
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
要用來取消接收作業的語彙基元。
傳回
接收到的值。
例外狀況
source
為 null
。
無法從來源接收項目。
指定的逾時在從來源接收項目之前到期。
從來源收到項目之前,已取消作業。
備註
如果來源已成功提供此作業所收到的專案值,即使發生並行逾時或取消要求,也會傳回該值。