WriteOnceBlock<T>.ISourceBlock<T>.ReserveMessage Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Вызывается связанным объектом 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<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> -> boolFunction ReserveMessage (messageHeader As DataflowMessageHeader, target As ITargetBlock(Of T)) As Boolean Implements ISourceBlock(Of T).ReserveMessageПараметры
- messageHeader
- DataflowMessageHeader
Объект DataflowMessageHeader резервируемого сообщения.
- target
- ITargetBlock<T>
ITargetBlock<TInput>, сохраняющий сообщение.
Возвращаемое значение
Значение true, если сообщение было успешно зарезервировано; в противном случае — значение false.
Реализации
Исключения
Недопустимое значение messageHeader.
Значение параметра target — null.
Комментарии
Только ITargetBlock<TInput> экземпляры, связанные с этим ISourceBlock<TOutput> экземпляром, могут использовать ReserveMessage, и он должен использоваться только для резервирования DataflowMessageHeader экземпляров, ранее предлагаемых этим источником для целевого объекта.
Если true возвращается , ITargetBlock<TInput> объект должен впоследствии вызвать или ConsumeMessageReleaseReservation для этого сообщения. Невыполнение этого действия может привести к тому, что источник не сможет распространить дополнительные сообщения на этот или другие целевые объекты.
ReserveMessage не должен вызываться, когда целевой объект удерживает какие-либо внутренние блокировки. Это приведет к нарушению иерархии блокировок, необходимой для предотвращения взаимоблокировок в сети потока данных.
