ITargetBlock<TInput>.OfferMessage Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Erbjuder ett meddelande till ITargetBlock<TInput>, vilket ger målet möjlighet att använda eller skjuta upp meddelandet.
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.DataflowMessageStatus
Public Function OfferMessage (messageHeader As DataflowMessageHeader, messageValue As TInput, source As ISourceBlock(Of In TInput), consumeToAccept As Boolean) As DataflowMessageStatus
Parametrar
- messageHeader
- DataflowMessageHeader
En DataflowMessageHeader instans som representerar rubriken för meddelandet som erbjuds.
- messageValue
- TInput
Värdet för meddelandet som erbjuds.
- source
- ISourceBlock<TInput>
Erbjudandet ISourceBlock<TOutput> meddelandet. Detta kan vara null.
- consumeToAccept
- Boolean
Ange till true för att instruera målet att anropa ConsumeMessage(DataflowMessageHeader, ITargetBlock<TOutput>, Boolean) synkront under anropet till OfferMessage(DataflowMessageHeader, TInput, ISourceBlock<TInput>, Boolean), innan det returneras Accepted, för att använda meddelandet.
Returer
Status för det erbjudna meddelandet. Om meddelandet accepterades av målet Accepted returneras och källan inte längre ska använda det erbjudna meddelandet, eftersom det nu ägs av målet. Om meddelandet sköts upp av målet Postponed returneras som ett meddelande om att målet senare kan försöka använda eller reservera meddelandet. Under tiden äger källan fortfarande meddelandet och kan erbjuda det till andra block.
Om målet annars skulle ha skjutit upp meddelandet, men källan var null, Declined returneras i stället.
Om målet försökte acceptera meddelandet men missade det på grund av att källan levererade meddelandet till ett annat mål eller helt enkelt ignorerade det, NotAvailable returneras.
Om målet valde att inte acceptera meddelandet Declined returneras. Om målet valde att inte acceptera meddelandet och aldrig kommer att acceptera ett annat meddelande från den här källan DecliningPermanently returneras.
Undantag
Är messageHeader inte giltig.
-or- consumeToAccept kan bara vara sant om det tillhandahålls med en icke-null source.