Compartilhar via


TransformBlock<TInput,TOutput>.ISourceBlock<TOutput>.ReserveMessage Método

Definição

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

 virtual bool System.Threading.Tasks.Dataflow.ISourceBlock<TOutput>.ReserveMessage(System::Threading::Tasks::Dataflow::DataflowMessageHeader messageHeader, System::Threading::Tasks::Dataflow::ITargetBlock<TOutput> ^ target) = System::Threading::Tasks::Dataflow::ISourceBlock<TOutput>::ReserveMessage;
bool ISourceBlock<TOutput>.ReserveMessage (System.Threading.Tasks.Dataflow.DataflowMessageHeader messageHeader, System.Threading.Tasks.Dataflow.ITargetBlock<TOutput> target);
abstract member System.Threading.Tasks.Dataflow.ISourceBlock<TOutput>.ReserveMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * System.Threading.Tasks.Dataflow.ITargetBlock<'Output> -> bool
override this.System.Threading.Tasks.Dataflow.ISourceBlock<TOutput>.ReserveMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * System.Threading.Tasks.Dataflow.ITargetBlock<'Output> -> bool
Function ReserveMessage (messageHeader As DataflowMessageHeader, target As ITargetBlock(Of TOutput)) As Boolean Implements ISourceBlock(Of TOutput).ReserveMessage

Parâmetros

messageHeader
DataflowMessageHeader

O DataflowMessageHeader da mensagem que é reservada.

target
ITargetBlock<TOutput>

O ITargetBlock<TInput> que reserva a mensagem.

Retornos

Boolean

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

Implementações

Exceções

O messageHeader não é válido.

O target é null.

Comentários

Somente ITargetBlock<TInput> instâncias vinculadas a essa ISourceBlock<TOutput> instância podem ser usadas ReserveMessage, e ela só deve ser usada para reservar DataflowMessageHeader instâncias oferecidas anteriormente por essa origem para o destino.

Se true for retornado, a ITargetBlock<TInput> mensagem deverá ser chamada ConsumeMessage posteriormente.ReleaseReservation Não fazer isso pode fazer com que a origem não possa propagar mais mensagens para esse 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