TransformManyBlock<TInput,TOutput>.ITargetBlock<TInput>.OfferMessage Метод

Определение

Предлагает сообщение блоку ITargetBlock<TInput>, предоставляя целевому объекту возможность использовать или отложить его.

 virtual System::Threading::Tasks::Dataflow::DataflowMessageStatus System.Threading.Tasks.Dataflow.ITargetBlock<TInput>.OfferMessage(System::Threading::Tasks::Dataflow::DataflowMessageHeader messageHeader, TInput messageValue, System::Threading::Tasks::Dataflow::ISourceBlock<TInput> ^ source, bool consumeToAccept) = System::Threading::Tasks::Dataflow::ITargetBlock<TInput>::OfferMessage;
System.Threading.Tasks.Dataflow.DataflowMessageStatus ITargetBlock<TInput>.OfferMessage (System.Threading.Tasks.Dataflow.DataflowMessageHeader messageHeader, TInput messageValue, System.Threading.Tasks.Dataflow.ISourceBlock<TInput> source, bool consumeToAccept);
abstract member System.Threading.Tasks.Dataflow.ITargetBlock<TInput>.OfferMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * 'Input * System.Threading.Tasks.Dataflow.ISourceBlock<'Input> * bool -> System.Threading.Tasks.Dataflow.DataflowMessageStatus
override this.System.Threading.Tasks.Dataflow.ITargetBlock<TInput>.OfferMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * 'Input * System.Threading.Tasks.Dataflow.ISourceBlock<'Input> * bool -> System.Threading.Tasks.Dataflow.DataflowMessageStatus
Function OfferMessage (messageHeader As DataflowMessageHeader, messageValue As TInput, source As ISourceBlock(Of TInput), consumeToAccept As Boolean) As DataflowMessageStatus Implements ITargetBlock(Of TInput).OfferMessage

Параметры

messageHeader
DataflowMessageHeader

Экземпляр DataflowMessageHeader, представляющий заголовок предлагаемого сообщения.

messageValue
TInput

Значение предлагаемого свойства.

source
ISourceBlock<TInput>

ISourceBlock<TOutput>, предлагающий сообщение. Это может быть значение null.

consumeToAccept
Boolean

Значение true, если целевой объект должен вызвать метод ConsumeMessage(DataflowMessageHeader, ITargetBlock<TOutput>, Boolean) асинхронно во время вызова ITargetBlock<TInput> до возврата Accepted, чтобы получить сообщение.

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

DataflowMessageStatus

Состояние предложенного сообщения. Если сообщение было принято целевым объектом, возвращается Accepted и источник больше не должен использовать предложенное сообщение, поскольку оно теперь принадлежит целевому объекту. Если сообщение было отложено целевым объектом, возвращается Postponed в качестве уведомления о том, что целевой объект может позже попытаться использовать или зарезервировать сообщение; при этом источник будет по-прежнему владеть сообщением и может предлагать его другим блокам.

Если целевой объект в противном случае отложил бы сообщение, но источник имел значение null, вместо этого возвращается Declined.

Если целевой объект попытался принять сообщение, но не получил его из-за доставки сообщения источником другому целевому объекту или просто отбрасывания сообщения источником, возвращается NotAvailable.

Если целевой объект принял решение не принимать сообщение, возвращается Declined. Если целевой объект принял решение не принимать сообщение и никогда не будет принимать другие сообщения от этого источника, возвращается DecliningPermanently.

Реализации

Исключения

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

-или- consumeToAccept может быть только значение true, если он получил source, отличный от null.

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