TransformManyBlock<TInput,TOutput>.ISourceBlock<TOutput>.ReserveMessage Metode

Definisi

Ruang nama:

System.Threading.Tasks.Dataflow

Rakitan:

System.Threading.Tasks.Dataflow.dll

Sumber:

TransformManyBlock.cs

Dipanggil oleh yang ditautkan ITargetBlock<TInput> untuk memesan yang sebelumnya ditawarkan DataflowMessageHeader oleh ini ISourceBlock<TOutput>.

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

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

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

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

Parameter

messageHeader

DataflowMessageHeader

Pesan DataflowMessageHeader yang sedang dicadangkan.

target

ITargetBlock<TOutput>

Yang ITargetBlock<TInput> mencairkan pesan.

Mengembalikan

Boolean

true jika pesan berhasil dicadangkan; jika tidak, false.

Penerapan

ReserveMessage(DataflowMessageHeader, ITargetBlock<TOutput>)

Pengecualian

ArgumentException

messageHeader tidak valid.

ArgumentNullException

target adalah null.

Keterangan

Hanya ITargetBlock<TInput> instans yang ditautkan ke instans ini ISourceBlock<TOutput> yang dapat menggunakan ReserveMessage, dan hanya boleh digunakan untuk memesan DataflowMessageHeader instans yang sebelumnya ditawarkan oleh sumber ini ke target.

Jika true dikembalikan, ITargetBlock<TInput> selanjutnya harus memanggil atau ConsumeMessageReleaseReservation untuk pesan ini. Kegagalan untuk melakukannya dapat mengakibatkan sumber tidak dapat menyebarluaskan pesan lebih lanjut ke target ini atau lainnya.

ReserveMessage tidak boleh dipanggil saat target memegang kunci internal apa pun. Melakukannya akan melanggar hierarki kunci yang diperlukan untuk menghindari kebuntuan dalam jaringan aliran data.