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