TransformManyBlock<TInput,TOutput>.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 de ITargetBlock<TInput>, waardoor het doel de mogelijkheid heeft 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
Een DataflowMessageHeader exemplaar dat de koptekst vertegenwoordigt van het bericht dat wordt aangeboden.
- messageValue
- TInput
De waarde van het bericht dat wordt aangeboden.
- source
- ISourceBlock<TInput>
Het ISourceBlock<TOutput> aanbod van het bericht. Dit kan zijn null.
- consumeToAccept
- Boolean
true als het doel synchroon moet worden aangeroepen tijdens de aanroep ConsumeMessage(DataflowMessageHeader, ITargetBlock<TOutput>, Boolean) naar ITargetBlock<TInput>, voordat het wordt geretourneerd Accepted, om het bericht te kunnen gebruiken.
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 zou zijn uitgesteld, maar bron was null, Declined wordt in plaats daarvan 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
De messageHeader waarde is ongeldig.
– of –
consumeToAccept mag alleen waar zijn als er een niet-null-waarde sourceis opgegeven.
