DataflowBlock.Receive 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| 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。
無法從來源接收任何物品。
指定的逾時時間在收到來源物品之前就已結束。
該行動在收到來源物資前即被取消。
備註
若來源成功提供該操作接收的項目值，即使同時發生逾時或取消請求，該值仍會回傳。
