DataflowBlock.Receive Método

Definição

Namespace:

System.Threading.Tasks.Dataflow

Assembly:

System.Threading.Tasks.Dataflow.dll

Pacote:

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

Sobrecargas

Receive<TOutput>(ISourceBlock<TOutput>)	Recebe de forma síncrona um valor de uma origem especificada.
Receive<TOutput>(ISourceBlock<TOutput>, CancellationToken)	Recebe de forma síncrona um valor de uma origem especificada e fornece um token para cancelar a operação.
Receive<TOutput>(ISourceBlock<TOutput>, TimeSpan)	Recebe de forma síncrona um valor de uma origem especificada, observando um período de tempo limite opcional.
Receive<TOutput>(ISourceBlock<TOutput>, TimeSpan, CancellationToken)	Recebe de forma síncrona um valor de uma fonte especificada, fornecendo um token para cancelar a operação e observando um intervalo de tempo limite opcional.

Receive<TOutput>(ISourceBlock<TOutput>)

Origem:

DataflowBlock.cs

Recebe de forma síncrona um valor de uma origem especificada.

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

Parâmetros de tipo

TOutput

O tipo de dados contido na origem.

Parâmetros

source

ISourceBlock<TOutput>

A origem da qual o valor será recebido.

Retornos

TOutput

O valor recebido.

Exceções

ArgumentNullException

source é null.

InvalidOperationException

Nenhum item pode ser recebido da origem.

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

Origem:

DataflowBlock.cs

Recebe de forma síncrona um valor de uma origem especificada e fornece um token para cancelar a operação.

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

Parâmetros de tipo

TOutput

O tipo de dados contido na origem.

Parâmetros

source

ISourceBlock<TOutput>

A origem da qual o valor será recebido.

cancellationToken

CancellationToken

O token a ser usado para cancelar a operação de recebimento.

Retornos

TOutput

O valor recebido.

Exceções

ArgumentNullException

source é null.

InvalidOperationException

Nenhum item pode ser recebido da origem.

OperationCanceledException

A operação foi cancelada antes de um item ser recebido da origem.

Comentários

Se a origem tiver oferecido com êxito um item que foi recebido por essa operação, esse item será retornado mesmo se ocorrer uma solicitação de cancelamento simultânea.

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

Origem:

DataflowBlock.cs

Recebe de forma síncrona um valor de uma origem especificada, observando um período de tempo limite opcional.

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

Parâmetros de tipo

TOutput

O tipo de dados contido na origem.

Parâmetros

source

ISourceBlock<TOutput>

A origem da qual o valor será recebido.

timeout

TimeSpan

O intervalo de tempo máximo, em milissegundos, de espera para a operação síncrona ser concluída ou um intervalo que representa -1 milissegundos para aguardar indefinidamente.

Retornos

TOutput

O valor recebido.

Exceções

ArgumentOutOfRangeException

timeout é um número negativo diferente de -1 milissegundo, que representa um período de tempo limite infinito.

- ou -

timeout é maior que Int32.MaxValue.

ArgumentNullException

source é null.

InvalidOperationException

Nenhum item pode ser recebido da origem.

TimeoutException

O tempo limite especificado expirou antes de um item ser recebido da origem.

Comentários

Se a origem tiver oferecido com êxito um item que foi recebido por essa operação, esse item será retornado mesmo se ocorrer um tempo limite simultâneo.

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

Origem:

DataflowBlock.cs

Recebe de forma síncrona um valor de uma fonte especificada, fornecendo um token para cancelar a operação e observando um intervalo de tempo limite opcional.

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

Parâmetros de tipo

TOutput

O tipo de dados contido na origem.

Parâmetros

source

ISourceBlock<TOutput>

A origem da qual o valor será recebido.

timeout

TimeSpan

O intervalo de tempo máximo, em milissegundos, de espera para a operação síncrona ser concluída ou um intervalo que representa -1 milissegundos para aguardar indefinidamente.

cancellationToken

CancellationToken

O token a ser usado para cancelar a operação de recebimento.

Retornos

TOutput

O valor recebido.

Exceções

ArgumentNullException

O source é null.

ArgumentOutOfRangeException

timeout é um número negativo diferente de -1 milissegundo, que representa um período de tempo limite infinito.

- ou -

timeout é maior que Int32.MaxValue.

InvalidOperationException

Nenhum item pode ser recebido da origem.

TimeoutException

O tempo limite especificado expirou antes de um item ser recebido da origem.

OperationCanceledException

A operação foi cancelada antes de um item ser recebido da origem.

Comentários

Se a origem tiver oferecido com êxito um valor de item que foi recebido por essa operação, esse valor será retornado mesmo se ocorrer um tempo limite simultâneo ou solicitação de cancelamento.