Sdílet prostřednictvím


WriteOnceBlock<T>.ISourceBlock<T>.ReserveMessage Metoda

Definice

Volá propojený ITargetBlock<TInput> , aby si rezervoval dříve nabízený DataflowMessageHeader tento ISourceBlock<TOutput>.

 virtual bool System.Threading.Tasks.Dataflow.ISourceBlock<T>.ReserveMessage(System::Threading::Tasks::Dataflow::DataflowMessageHeader messageHeader, System::Threading::Tasks::Dataflow::ITargetBlock<T> ^ target) = System::Threading::Tasks::Dataflow::ISourceBlock<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

Parametry

messageHeader
DataflowMessageHeader

Zpráva DataflowMessageHeader , která je rezervována.

target
ITargetBlock<T>

Rezervace ITargetBlock<TInput> zprávy.

Návraty

truepokud byla zpráva úspěšně rezervována; v opačném případě . false

Implementuje

Výjimky

Hodnota messageHeader není platná.

Hodnota target je null.

Poznámky

Používat mohou pouze ITargetBlock<TInput> instance propojené s touto ISourceBlock<TOutput> instancí a musí být použity pouze k rezervaci DataflowMessageHeader instancí dříve nabízených tímto zdrojem pro ReserveMessagecíl.

Pokud true je vrácena, ITargetBlock<TInput> musí následně volat buď ConsumeMessage nebo ReleaseReservation pro tuto zprávu. Pokud to neuděláte, může to vést k tomu, že zdroj nebude moct rozšířit žádné další zprávy do tohoto nebo jiného cíle.

ReserveMessage nesmí být volána, pokud cíl drží interní zámky. Tím dojde k porušení hierarchie zámků, která je nezbytná k tomu, aby se zabránilo vzájemnému zablokování v síti toku dat.

Platí pro