BatchBlock<T>.ISourceBlock<T[]>.ReserveMessage Метод

Ссылка

Определение

Пространство имен:: System.Threading.Tasks.Dataflow

Сборка:: System.Threading.Tasks.Dataflow.dll

Пакет:: System.Threading.Tasks.Dataflow v8.0.1

Пакет:: System.Threading.Tasks.Dataflow v9.0.0-rc.2.24473.5

Исходный код:: BatchBlock.cs

Исходный код:: BatchBlock.cs

Исходный код:: BatchBlock.cs

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Вызывается связанным объектом ITargetBlock<TInput> для резервирования объекта DataflowMessageHeader, ранее предложенного этим объектом ISourceBlock<TOutput>.

 virtual bool System.Threading.Tasks.Dataflow.ISourceBlock<T[]>.ReserveMessage(System::Threading::Tasks::Dataflow::DataflowMessageHeader messageHeader, System::Threading::Tasks::Dataflow::ITargetBlock<cli::array <T> ^> ^ target) = System::Threading::Tasks::Dataflow::ISourceBlock<cli::array <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

Параметры

messageHeader: DataflowMessageHeader

Объект DataflowMessageHeader резервируемого сообщения.

target: ITargetBlock<T[]>

ITargetBlock<TInput>, сохраняющий сообщение.

Возвращаемое значение

Boolean

Значение true, если сообщение было успешно зарезервировано; в противном случае — значение false.

Реализации

ReserveMessage(DataflowMessageHeader, ITargetBlock<TOutput>)

Исключения

ArgumentException

Недопустимое значение messageHeader.

ArgumentNullException

Значение параметра target — null.

Только ITargetBlock<TInput> экземпляры, связанные с этим ISourceBlock<TOutput> экземпляром, могут использовать ReserveMessage, и они должны использоваться только для резервирования DataflowMessageHeader экземпляров, ранее предлагаемых этим источником для целевого объекта.

Если true возвращается значение , ITargetBlock<TInput> объект должен впоследствии вызвать или ConsumeMessage ReleaseReservation для этого сообщения. В противном случае источник не сможет распространить сообщения на этот или другие целевые объекты.

ReserveMessage не должен вызываться, пока целевой объект удерживает внутренние блокировки. Это приведет к нарушению иерархии блокировок, необходимой для предотвращения взаимоблокировок в сети потока данных.

Применяется к

Поделиться через