ISourceBlock<TOutput>.ReserveMessage Метод

Ссылка

Определение

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

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

Важно!

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

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

public:
 bool ReserveMessage(System::Threading::Tasks::Dataflow::DataflowMessageHeader messageHeader, System::Threading::Tasks::Dataflow::ITargetBlock<TOutput> ^ target);

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

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

Public Function ReserveMessage (messageHeader As DataflowMessageHeader, target As ITargetBlock(Of Out TOutput)) As Boolean

Параметры

messageHeader: DataflowMessageHeader

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

target: ITargetBlock<TOutput>

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

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

Boolean

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

Исключения

ArgumentException

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

ArgumentNullException

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

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

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

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

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