BatchBlock<T>.ISourceBlock<T[]>.ReserveMessage Método

Referência

Definição

Namespace:: System.Threading.Tasks.Dataflow

Assembly:: System.Threading.Tasks.Dataflow.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Chamado por um ITargetBlock<TInput> vinculado para reservar um DataflowMessageHeader oferecido anteriormente por este ISourceBlock<TOutput>.

 virtual bool System.Threading.Tasks.Dataflow.ISourceBlock<T[]>.ReserveMessage(System::Threading::Tasks::Dataflow::DataflowMessageHeader messageHeader, System::Threading::Tasks::Dataflow::ITargetBlock<cli::array <T> ^> ^ target) = System::Threading::Tasks::Dataflow::ISourceBlock<cli::array <T> ^>::ReserveMessage;

bool ISourceBlock<T[]>.ReserveMessage (System.Threading.Tasks.Dataflow.DataflowMessageHeader messageHeader, System.Threading.Tasks.Dataflow.ITargetBlock<T[]> target);

abstract member System.Threading.Tasks.Dataflow.ISourceBlock<T[]>.ReserveMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * System.Threading.Tasks.Dataflow.ITargetBlock<'T[]> -> bool
override this.System.Threading.Tasks.Dataflow.ISourceBlock<T[]>.ReserveMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * System.Threading.Tasks.Dataflow.ITargetBlock<'T[]> -> bool

Function ReserveMessage (messageHeader As DataflowMessageHeader, target As ITargetBlock(Of T())) As Boolean Implements ISourceBlock(Of T()).ReserveMessage

Parâmetros

messageHeader: DataflowMessageHeader

O DataflowMessageHeader da mensagem que é reservada.

target: ITargetBlock<T[]>

O ITargetBlock<TInput> que reserva a mensagem.

Retornos

Boolean

true se a mensagem foi reservada com êxito; caso contrário, false.

Implementações

ReserveMessage(DataflowMessageHeader, ITargetBlock<TOutput>)

Exceções

ArgumentException

O messageHeader não é válido.

ArgumentNullException

O target é null.

Comentários

Somente ITargetBlock<TInput> instâncias vinculadas a essa ISourceBlock<TOutput> instância podem ser usadas ReserveMessagee elas só devem ser usadas para reservar DataflowMessageHeader instâncias oferecidas anteriormente por essa fonte para o destino.

Se true for retornado, a ITargetBlock<TInput> chamada deverá ser chamada ConsumeMessage posteriormente ou ReleaseReservation para essa mensagem. A falha ao fazer isso pode fazer com que a origem não consiga propagar mais mensagens para este ou outros destinos.

ReserveMessage não deve ser chamado enquanto o destino estiver mantendo bloqueios internos. Isso violará a hierarquia de bloqueio necessária para evitar deadlocks em uma rede de fluxo de dados.

Aplica-se a

Compartilhar via