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


TransformManyBlock<TInput,TOutput>.ISourceBlock<TOutput>.ReserveMessage Метод

Определение

Вызывается связанным объектом ITargetBlock<TInput> для резервирования объекта DataflowMessageHeader, ранее предложенного этим объектом 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

Параметры

messageHeader
DataflowMessageHeader

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

target
ITargetBlock<TOutput>

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

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

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

Реализации

Исключения

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

Значение параметра targetnull.

Комментарии

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

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

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

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