DataflowBlock.Receive Method
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
| Receive<TOutput>(ISourceBlock<TOutput>) |
Synchronously receives a value from a specified source. |
| Receive<TOutput>(ISourceBlock<TOutput>, CancellationToken) |
Synchronously receives a value from a specified source and provides a token to cancel the operation. |
| Receive<TOutput>(ISourceBlock<TOutput>, TimeSpan) |
Synchronously receives a value from a specified source, observing an optional time-out period. |
| Receive<TOutput>(ISourceBlock<TOutput>, TimeSpan, CancellationToken) |
Synchronously receives a value from a specified source, providing a token to cancel the operation and observing an optional time-out interval. |
- Source:
- DataflowBlock.cs
- Source:
- DataflowBlock.cs
- Source:
- DataflowBlock.cs
- Source:
- DataflowBlock.cs
Synchronously receives a value from a specified source.
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 TOutputType Parameters
- TOutput
The type of data contained in the source.
Parameters
- source
- ISourceBlock<TOutput>
The source from which to receive the value.
Returns
The received value.
Exceptions
source is null.
No item could be received from the source.
Applies to
.NET 10 and other versions
| Product | Versions |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8 (package-provided), 8, 9 (package-provided), 9, 10 (package-provided), 10 |
| .NET Standard | 2.0 (package-provided), 2.1 (package-provided) |
| UWP | 10.0 |
- Source:
- DataflowBlock.cs
- Source:
- DataflowBlock.cs
- Source:
- DataflowBlock.cs
- Source:
- DataflowBlock.cs
Synchronously receives a value from a specified source and provides a token to cancel the operation.
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 TOutputType Parameters
- TOutput
The type of data contained in the source.
Parameters
- source
- ISourceBlock<TOutput>
The source from which to receive the value.
- cancellationToken
- CancellationToken
The token to use to cancel the receive operation.
Returns
The received value.
Exceptions
source is null.
No item could be received from the source.
The operation was canceled before an item was received from the source.
Remarks
If the source successfully offered an item that was received by this operation, that item is returned even if a concurrent cancellation request occurs.
Applies to
.NET 10 and other versions
| Product | Versions |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8 (package-provided), 8, 9 (package-provided), 9, 10 (package-provided), 10 |
| .NET Standard | 2.0 (package-provided), 2.1 (package-provided) |
| UWP | 10.0 |
- Source:
- DataflowBlock.cs
- Source:
- DataflowBlock.cs
- Source:
- DataflowBlock.cs
- Source:
- DataflowBlock.cs
Synchronously receives a value from a specified source, observing an optional time-out period.
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 TOutputType Parameters
- TOutput
The type of data contained in the source.
Parameters
- source
- ISourceBlock<TOutput>
The source from which to receive the value.
- timeout
- TimeSpan
The maximum time interval, in milliseconds, to wait for the synchronous operation to complete, or an interval that represents -1 milliseconds to wait indefinitely.
Returns
The received value.
Exceptions
timeout is a negative number other than -1 milliseconds, which represents an infinite time-out period.
-or-
timeout is greater than Int32.MaxValue.
source is null.
No item could be received from the source.
The specified time-out expired before an item was received from the source.
Remarks
If the source successfully offered an item that was received by this operation, that item is returned even if a concurrent time-out occurs.
Applies to
.NET 10 and other versions
| Product | Versions |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8 (package-provided), 8, 9 (package-provided), 9, 10 (package-provided), 10 |
| .NET Standard | 2.0 (package-provided), 2.1 (package-provided) |
| UWP | 10.0 |
- Source:
- DataflowBlock.cs
- Source:
- DataflowBlock.cs
- Source:
- DataflowBlock.cs
- Source:
- DataflowBlock.cs
Synchronously receives a value from a specified source, providing a token to cancel the operation and observing an optional time-out interval.
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 TOutputType Parameters
- TOutput
The type of data contained in the source.
Parameters
- source
- ISourceBlock<TOutput>
The source from which to receive the value.
- timeout
- TimeSpan
The maximum time interval, in milliseconds, to wait for the synchronous operation to complete, or an interval that represents -1 milliseconds to wait indefinitely.
- cancellationToken
- CancellationToken
The token to use to cancel the receive operation.
Returns
The received value.
Exceptions
The source is null.
timeout is a negative number other than -1 milliseconds, which represents an infinite time-out period.
-or-
timeout is greater than Int32.MaxValue.
No item could be received from the source.
The specified time-out expired before an item was received from the source.
The operation was canceled before an item was received from the source.
Remarks
If the source successfully offered an item value that was received by this operation, that value is returned even if a concurrent time-out or cancellation request occurs.
Applies to
.NET 10 and other versions
| Product | Versions |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8 (package-provided), 8, 9 (package-provided), 9, 10 (package-provided), 10 |
| .NET Standard | 2.0 (package-provided), 2.1 (package-provided) |
| UWP | 10.0 |
.NET feedback
.NET is an open source project. Select a link to provide feedback: