ISourceBlock<TOutput>.ConsumeMessage Methode

Referenz

Definition

Namespace:: System.Threading.Tasks.Dataflow

Assembly:: System.Threading.Tasks.Dataflow.dll

Paket:: System.Threading.Tasks.Dataflow v8.0.0

Paket:: System.Threading.Tasks.Dataflow v9.0.0-preview.3.24172.9

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

ArgumentException

Der messageHeader ist ungültig.

ArgumentNullException

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: