ISourceBlock<TOutput>.ReserveMessage Methode

Referenz

Definition

Namespace:: System.Threading.Tasks.Dataflow

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

Paket:: System.Threading.Tasks.Dataflow v10.0.0-preview.1.25080.5

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 einem verknüpften ITargetBlock<TInput>, um einen DataflowMessageHeader, der von diesem ISourceBlock<TOutput> zuvor angeboten wurde, zu reservieren.

public:
 bool ReserveMessage(System::Threading::Tasks::Dataflow::DataflowMessageHeader messageHeader, System::Threading::Tasks::Dataflow::ITargetBlock<TOutput> ^ target);

public bool ReserveMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader messageHeader, System.Threading.Tasks.Dataflow.ITargetBlock<out TOutput> target);

abstract member ReserveMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * System.Threading.Tasks.Dataflow.ITargetBlock<'Output> -> bool

Public Function ReserveMessage (messageHeader As DataflowMessageHeader, target As ITargetBlock(Of Out TOutput)) As Boolean

Parameter

messageHeader: DataflowMessageHeader

DataflowMessageHeader der Meldung, die reserviert wird.

target: ITargetBlock<TOutput>

Die ITargetBlock<TInput> der Meldung empfängt.

Gibt zurück

Boolean

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

Ausnahmen

ArgumentException

Der messageHeader ist ungültig.

ArgumentNullException

target ist null.

Hinweise

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

Wenn true zurückgegeben wird, muss anschließend ITargetBlock<TInput> entweder ConsumeMessage oder ReleaseReservation für diese Nachricht aufgerufen werden. Andernfalls kann die Quelle keine weiteren Nachrichten an dieses oder andere Ziele weitergeben.

ReserveMessage darf nicht aufgerufen werden, während das Ziel interne Sperren enthält. Dadurch wird die Sperrhierarchie verletzt, die erforderlich ist, um Deadlocks in einem Dataflownetzwerk zu vermeiden.

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, 7, 8 (package-provided), 8, 9 (package-provided), 9, 10 (package-provided), 10
.NET Standard	2.0 (package-provided), 2.1 (package-provided)
UWP	10.0

Freigeben über