ISourceBlock<TOutput>.ConsumeMessage Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Wywołana przez element połączony ITargetBlock<TInput> w celu zaakceptowania i korzystania z elementu oferowanego wcześniej przez tę ISourceBlock<TOutput>usługę DataflowMessageHeader .
public TOutput ConsumeMessage (System.Threading.Tasks.Dataflow.DataflowMessageHeader messageHeader, System.Threading.Tasks.Dataflow.ITargetBlock<out TOutput> target, out bool messageConsumed);
public TOutput? ConsumeMessage (System.Threading.Tasks.Dataflow.DataflowMessageHeader messageHeader, System.Threading.Tasks.Dataflow.ITargetBlock<out TOutput> target, out bool messageConsumed);
abstract member ConsumeMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * System.Threading.Tasks.Dataflow.ITargetBlock<'Output> * bool -> 'Output
Public Function ConsumeMessage (messageHeader As DataflowMessageHeader, target As ITargetBlock(Of Out TOutput), ByRef messageConsumed As Boolean) As TOutput
Parametry
- messageHeader
- DataflowMessageHeader
Element DataflowMessageHeader używanego komunikatu.
- target
- ITargetBlock<TOutput>
Korzystanie ITargetBlock<TInput> z komunikatu.
- messageConsumed
- Boolean
true
jeśli komunikat został pomyślnie użyty; w przeciwnym razie , false
.
Zwraca
Wartość zużytego komunikatu. Może to odpowiadać innego DataflowMessageHeader wystąpienia niż wcześniej zarezerwowane i przekazane jako .messageHeader
ConsumeMessage(DataflowMessageHeader, ITargetBlock<TOutput>, Boolean) Użycie ITargetBlock<TInput> musi używać zwróconej wartości zamiast wartości przekazanej jako messageValue
za pośrednictwem OfferMessage(DataflowMessageHeader, TInput, ISourceBlock<TInput>, Boolean).
Jeśli żądany komunikat jest niedostępny, zwracana wartość będzie mieć wartość null.
Wyjątki
Element messageHeader jest nieprawidłowy.
Elementem docelowym jest null
.
Uwagi
Tylko ITargetBlock<TInput> wystąpienia połączone z tym ISourceBlock<TOutput> wystąpieniem mogą używać elementu ConsumeMessagei muszą być używane tylko do korzystania DataflowMessageHeader z wystąpień oferowanych wcześniej przez to źródło do obiektu docelowego.