ActionBlock<TInput>.ITargetBlock<TInput>.OfferMessage Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Biedt een bericht aan het gegevensstroomblok en biedt het de mogelijkheid om het bericht te gebruiken of uit te stellen.
virtual System::Threading::Tasks::Dataflow::DataflowMessageStatus System.Threading.Tasks.Dataflow.ITargetBlock<TInput>.OfferMessage(System::Threading::Tasks::Dataflow::DataflowMessageHeader messageHeader, TInput messageValue, System::Threading::Tasks::Dataflow::ISourceBlock<TInput> ^ source, bool consumeToAccept) = System::Threading::Tasks::Dataflow::ITargetBlock<TInput>::OfferMessage;System.Threading.Tasks.Dataflow.DataflowMessageStatus ITargetBlock<TInput>.OfferMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader messageHeader, TInput messageValue, System.Threading.Tasks.Dataflow.ISourceBlock<TInput> source, bool consumeToAccept);abstract member System.Threading.Tasks.Dataflow.ITargetBlock<TInput>.OfferMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * 'Input * System.Threading.Tasks.Dataflow.ISourceBlock<'Input> * bool -> System.Threading.Tasks.Dataflow.DataflowMessageStatus
override this.System.Threading.Tasks.Dataflow.ITargetBlock<TInput>.OfferMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * 'Input * System.Threading.Tasks.Dataflow.ISourceBlock<'Input> * bool -> System.Threading.Tasks.Dataflow.DataflowMessageStatusFunction OfferMessage (messageHeader As DataflowMessageHeader, messageValue As TInput, source As ISourceBlock(Of TInput), consumeToAccept As Boolean) As DataflowMessageStatus Implements ITargetBlock(Of TInput).OfferMessageParameters
- messageHeader
- DataflowMessageHeader
De koptekst van het bericht dat wordt aangeboden.
- messageValue
- TInput
De waarde van het bericht dat wordt aangeboden.
- source
- ISourceBlock<TInput>
Het gegevensstroomblok dat het bericht aanbiedt. Dit kan zijn null.
- consumeToAccept
- Boolean
trueom het doel te instrueren om synchroon aan te roepen ConsumeMessage(DataflowMessageHeader, ITargetBlock<TOutput>, Boolean) tijdens de aanroep naar OfferMessage(DataflowMessageHeader, TInput, ISourceBlock<TInput>, Boolean), voordat het wordt geretourneerd Accepted, om het bericht te gebruiken; anders . false
Retouren
De status van het aangeboden bericht. Als het bericht is geaccepteerd door het doel, Accepted wordt geretourneerd en de bron het aangeboden bericht niet meer mag gebruiken, omdat het nu eigendom is van het doel. Als het bericht door het doel is uitgesteld, Postponed wordt het geretourneerd als een melding dat het doel later kan proberen het bericht te gebruiken of te reserveren. Ondertussen is de bron nog steeds eigenaar van het bericht en kan het aan andere blokken worden aangeboden.
Als het doel anders het bericht zou hebben uitgesteld, maar bron was null, Declined wordt geretourneerd.
Als het doel probeert het bericht te accepteren, maar het bericht heeft gemist vanwege de bron die het bericht aan een ander doel levert of het bericht gewoon negeert, NotAvailable wordt het geretourneerd.
Als het doel ervoor heeft gekozen het bericht niet te accepteren, Declined wordt het geretourneerd. Als het doel ervoor heeft gekozen het bericht niet te accepteren en nooit een ander bericht van deze bron accepteert, DecliningPermanently wordt deze geretourneerd.
Implementeringen
Uitzonderingen
messageHeader is ongeldig.
-of- consumeToAccept mag alleen worden true opgegeven bij een niet-null-waarde source.
