BatchBlock<T>.ISourceBlock<T[]>.ConsumeMessage Methode

Definition

Wird von einem verknüpften ITargetBlock<TInput>-Objekt aufgerufen, um ein DataflowMessageHeader-Objekt zu akzeptieren und zu verarbeiten, das zuvor durch dieses ISourceBlock<TOutput> angeboten wurde.

T[] ISourceBlock<T[]>.ConsumeMessage (System.Threading.Tasks.Dataflow.DataflowMessageHeader messageHeader, System.Threading.Tasks.Dataflow.ITargetBlock<T[]> target, out bool messageConsumed);

Parameter

messageHeader
DataflowMessageHeader

DataflowMessageHeader der Meldung, die verarbeitet wird.

target
ITargetBlock<T[]>

Die ITargetBlock<TInput>, die die Nachricht verwendet.

messageConsumed
Boolean

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

Gibt zurück

T[]

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.

Implementiert

Ausnahmen

Der messageHeader ist ungültig.

target 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:

Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6 (package-provided), 6, 7 (package-provided), 7, 8 (package-provided), 8, 9 (package-provided), 9
.NET Framework 4.7 (package-provided), 4.7.1 (package-provided), 4.7.2 (package-provided), 4.8 (package-provided)
.NET Standard 2.0 (package-provided), 2.1 (package-provided)
UWP 10.0