JoinBlock<T1,T2,T3>.ISourceBlock<Tuple<T1,T2,T3>>.ReserveMessage Método

Definição

Namespace:

System.Threading.Tasks.Dataflow

Assembly:

System.Threading.Tasks.Dataflow.dll

Pacote:

System.Threading.Tasks.Dataflow v9.0.0-rc.2.24473.5

Origem:

JoinBlock.cs

Reserva o direito de passar a propriedade da mensagem identificada pelo DataflowMessageHeader desse ISourceBlock<TOutput> para o ITargetBlock<TInput>.

 virtual bool System.Threading.Tasks.Dataflow.ISourceBlock<System.Tuple<T1,T2,T3>>.ReserveMessage(System::Threading::Tasks::Dataflow::DataflowMessageHeader messageHeader, System::Threading::Tasks::Dataflow::ITargetBlock<Tuple<T1, T2, T3> ^> ^ target) = System::Threading::Tasks::Dataflow::ISourceBlock<Tuple<T1, T2, T3> ^>::ReserveMessage;

bool ISourceBlock<Tuple<T1,T2,T3>>.ReserveMessage (System.Threading.Tasks.Dataflow.DataflowMessageHeader messageHeader, System.Threading.Tasks.Dataflow.ITargetBlock<Tuple<T1,T2,T3>> target);

abstract member System.Threading.Tasks.Dataflow.ISourceBlock<System.Tuple<T1,T2,T3>>.ReserveMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * System.Threading.Tasks.Dataflow.ITargetBlock<'T1 * 'T2 * 'T3> -> bool
override this.System.Threading.Tasks.Dataflow.ISourceBlock<System.Tuple<T1,T2,T3>>.ReserveMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * System.Threading.Tasks.Dataflow.ITargetBlock<'T1 * 'T2 * 'T3> -> bool

Function ReserveMessage (messageHeader As DataflowMessageHeader, target As ITargetBlock(Of Tuple(Of T1, T2, T3))) As Boolean Implements ISourceBlock(Of Tuple(Of T1, T2, T3)).ReserveMessage

Parâmetros

messageHeader

DataflowMessageHeader

O DataflowMessageHeader da mensagem a ser reservada.

target

ITargetBlock<Tuple<T1,T2,T3>>

O ITargetBlock<TInput> para o qual a mensagem deverá ser reservada.

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 (Nothing no Visual Basic).

Comentários

O ITargetBlock<TInput> para o qual a mensagem deve ser reservada não precisa ser vinculado a partir dessa ISourceBlock<TOutput> instância. Além disso, essa ISourceBlock<TOutput> instância pode nunca ter oferecido a mensagem diretamente ao ITargetBlock<TInput>.

Se true for retornado, você deverá chamar posteriormente ou ConsumeMessageReleaseReservation para essa mensagem com o mesmo DataflowMessageHeader e ITargetBlock<TInput>. Se você não fizer isso, a origem poderá não conseguir propagar mais mensagens para qualquer destino.

Não chame ReserveMessage 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.