Freigeben über


ISourceBlock<TOutput>.ConsumeMessage Methode

Definition

Wird von verknüpften ITargetBlock<TInput> aufgerufen, um einen DataflowMessageHeader zu akzeptieren und verarbeiten, die zuvor durch dieses ISourceBlock<TOutput> angeboten werden.

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

Parameter

messageHeader
DataflowMessageHeader

DataflowMessageHeader der Meldung, die verarbeitet wird.

target
ITargetBlock<TOutput>

Die ITargetBlock<TInput>, die die Nachricht verwendet.

messageConsumed
Boolean

true, wenn die Nachricht erfolgreich verarbeitet wurde, andernfalls false.

Gibt zurück

TOutput

Der Wert der verarbeiteten Meldung. Dies entspricht möglicherweise einer anderen DataflowMessageHeader-Instanz als die zuvor reservierte und die als messageHeader an ConsumeMessage(DataflowMessageHeader, ITargetBlock<TOutput>, Boolean) übergebene. Der ITargetBlock<TInput> muss den zurückgegebenen Wert benutzen und nicht den Wert, der als messageValue von OfferMessage(DataflowMessageHeader, TInput, ISourceBlock<TInput>, Boolean) übergeben wird.

Wenn die Meldung, die angefordert wird, nicht verfügbar ist, ist der Rückgabewert NULL.

Ausnahmen

Der messageHeader ist ungültig.

Das Ziel ist null.

Hinweise

Nur ITargetBlock<TInput> Instanzen, die mit dieser ISourceBlock<TOutput> Instanz verknüpft sind, können verwenden ConsumeMessage, und sie darf nur verwendet werden, um Instanzen zu nutzen DataflowMessageHeader , die zuvor von dieser Quelle für das Ziel angeboten wurden.

Gilt für: