BroadcastBlock<T>.ITargetBlock<T>.OfferMessage Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Nabízí zprávu ITargetBlock<TInput>, která cílovému cíli dává příležitost ke zpracování nebo odložení zprávy.
virtual System::Threading::Tasks::Dataflow::DataflowMessageStatus System.Threading.Tasks.Dataflow.ITargetBlock<T>.OfferMessage(System::Threading::Tasks::Dataflow::DataflowMessageHeader messageHeader, T messageValue, System::Threading::Tasks::Dataflow::ISourceBlock<T> ^ source, bool consumeToAccept) = System::Threading::Tasks::Dataflow::ITargetBlock<T>::OfferMessage;
System.Threading.Tasks.Dataflow.DataflowMessageStatus ITargetBlock<T>.OfferMessage (System.Threading.Tasks.Dataflow.DataflowMessageHeader messageHeader, T messageValue, System.Threading.Tasks.Dataflow.ISourceBlock<T> source, bool consumeToAccept);
abstract member System.Threading.Tasks.Dataflow.ITargetBlock<T>.OfferMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * 'T * System.Threading.Tasks.Dataflow.ISourceBlock<'T> * bool -> System.Threading.Tasks.Dataflow.DataflowMessageStatus
override this.System.Threading.Tasks.Dataflow.ITargetBlock<T>.OfferMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * 'T * System.Threading.Tasks.Dataflow.ISourceBlock<'T> * bool -> System.Threading.Tasks.Dataflow.DataflowMessageStatus
Function OfferMessage (messageHeader As DataflowMessageHeader, messageValue As T, source As ISourceBlock(Of T), consumeToAccept As Boolean) As DataflowMessageStatus Implements ITargetBlock(Of T).OfferMessage
Parametry
- messageHeader
- DataflowMessageHeader
Instance DataflowMessageHeader , která představuje záhlaví nabízené zprávy.
- messageValue
- T
Hodnota nabízené zprávy.
- source
- ISourceBlock<T>
Nabídka ISourceBlock<TOutput> zprávy. To může mít hodnotu null.
- consumeToAccept
- Boolean
Nastavte na true
pokyn cíli, aby ConsumeMessage(DataflowMessageHeader, ITargetBlock<TOutput>, Boolean) během hovoru OfferMessage(DataflowMessageHeader, TInput, ISourceBlock<TInput>, Boolean)volal synchronně před návratem Accepted, aby zprávu spotřeboval.
Návraty
Stav nabízené zprávy. Pokud cíl zprávu přijal, Accepted vrátí se a zdroj by už neměl nabízenou zprávu používat, protože je teď vlastněn cílem. Pokud cíl zprávu odložil, vrátí se jako oznámení, Postponed že se cíl může později pokusit zprávu použít nebo rezervovat. Mezitím zdroj zprávu stále vlastní a může ji nabídnout jiným blokům.
Pokud by cíl jinak odložil zprávu, ale source
byla null
, Declined je vrácena.
Pokud se cíl pokusil zprávu přijmout, ale zmeškal ji kvůli zdroji, který zprávu doručuje do jiného cíle, nebo ji jednoduše zahodí, NotAvailable vrátí se.
Pokud se cíl rozhodl zprávu nepřijmout, Declined vrátí se. Pokud se cíl rozhodl zprávu přijmout a nikdy nepřijme jinou zprávu z tohoto zdroje, DecliningPermanently vrátí se.
Implementuje
Výjimky
Tato messageHeader
hodnota není platná.
-nebo- consumeToAccept
může být true pouze v případě, že je k dispozici s hodnotou null source
.