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.
public System.Threading.Tasks.Dataflow.DataflowMessageStatus OfferMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader messageHeader, TInput messageValue, System.Threading.Tasks.Dataflow.ISourceBlock<in TInput> source, bool consumeToAccept);public System.Threading.Tasks.Dataflow.DataflowMessageStatus OfferMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader messageHeader, TInput messageValue, System.Threading.Tasks.Dataflow.ISourceBlock<in TInput>? source, bool consumeToAccept);abstract member OfferMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * 'Input * System.Threading.Tasks.Dataflow.ISourceBlock<'Input> * bool -> System.Threading.Tasks.Dataflow.DataflowMessageStatusPublic Function OfferMessage (messageHeader As DataflowMessageHeader, messageValue As TInput, source As ISourceBlock(Of In TInput), consumeToAccept As Boolean) As DataflowMessageStatusParameters
- 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 null zijn.
- consumeToAccept
- Boolean
Ingesteld om true 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 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 het bericht zou hebben 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.
Uitzonderingen
De messageHeader waarde is ongeldig.
-of- consumeToAccept mag alleen waar zijn als er een niet-null-waarde sourceis opgegeven.
