ISourceBlock<TOutput>.ConsumeMessage Metoda

Definicja

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

TOutput

Wartość zużytego komunikatu. Może to odpowiadać innego DataflowMessageHeader wystąpienia niż wcześniej zarezerwowane i przekazane jako .messageHeaderConsumeMessage(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.

Dotyczy