WriteOnceBlock<T>.ISourceBlock<T>.ReserveMessage Methode

Referenz

Definition

Namespace:: System.Threading.Tasks.Dataflow

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

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

Paket:: System.Threading.Tasks.Dataflow v9.0.0-rc.2.24473.5

Quelle:: WriteOnceBlock.cs

Quelle:: WriteOnceBlock.cs

Quelle:: WriteOnceBlock.cs

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.

 virtual bool System.Threading.Tasks.Dataflow.ISourceBlock<T>.ReserveMessage(System::Threading::Tasks::Dataflow::DataflowMessageHeader messageHeader, System::Threading::Tasks::Dataflow::ITargetBlock<T> ^ target) = System::Threading::Tasks::Dataflow::ISourceBlock<T>::ReserveMessage;

bool ISourceBlock<T>.ReserveMessage (System.Threading.Tasks.Dataflow.DataflowMessageHeader messageHeader, System.Threading.Tasks.Dataflow.ITargetBlock<T> target);

abstract member System.Threading.Tasks.Dataflow.ISourceBlock<T>.ReserveMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * System.Threading.Tasks.Dataflow.ITargetBlock<'T> -> bool
override this.System.Threading.Tasks.Dataflow.ISourceBlock<T>.ReserveMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * System.Threading.Tasks.Dataflow.ITargetBlock<'T> -> bool

Function ReserveMessage (messageHeader As DataflowMessageHeader, target As ITargetBlock(Of T)) As Boolean Implements ISourceBlock(Of T).ReserveMessage

Parameter

messageHeader: DataflowMessageHeader

DataflowMessageHeader der Meldung, die reserviert wird.

target: ITargetBlock<T>

Die ITargetBlock<TInput> der Meldung empfängt.

Gibt zurück

Boolean

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

Implementiert

ReserveMessage(DataflowMessageHeader, ITargetBlock<TOutput>)

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 ReserveMessageund dürfen 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 die ITargetBlock<TInput> entweder oder ConsumeMessage ReleaseReservation für diese Nachricht aufrufen. Andernfalls kann die Quelle keine weiteren Nachrichten an dieses oder andere Ziele verteilen.

ReserveMessage darf nicht aufgerufen werden, während das Ziel interne Sperren enthält. Dies verstößt gegen die Sperrhierarchie, die erforderlich ist, um Deadlocks in einem Dataflownetzwerk zu vermeiden.

Gilt für:

Freigeben über