共用方式為

ActionBlock<TInput>.ITargetBlock<TInput>.OfferMessage 方法

  • 參考

定義

命名空間:
System.Threading.Tasks.Dataflow
組件:
System.Threading.Tasks.Dataflow.dll

提供訊息給資料流程區塊，讓它有機會使用或延後訊息。

 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

正在提供的訊息的標頭。

messageValue
TInput

正在提供的訊息的值。

source
ISourceBlock<TInput>

提供訊息的資料流程區塊。 這可能是 null。

consumeToAccept
Boolean

設為 true 以指示目標在傳回 Accepted 之前，於呼叫 OfferMessage(DataflowMessageHeader, TInput, ISourceBlock<TInput>, Boolean) 期間以非同步方式呼叫 ConsumeMessage(DataflowMessageHeader, ITargetBlock<TOutput>, Boolean)，以便使用訊息；否則設為 false。

傳回

DataflowMessageStatus

提供之訊息的狀態。 如果目標已接受訊息，則會傳回 Accepted，而且來源不應該再使用所提供的訊息，因為現在它是由目標擁有。 如果訊息已由目標延後，會以通知形式傳回 Postponed，目標稍後可能會嘗試使用或保留訊息，同時來源仍擁有訊息，而且可能會將訊息提供給其他區塊。

如果目標會延後訊息，但來源是 null，則會傳回 Declined。

如果目標嘗試接受訊息，但因為來源將訊息傳遞給另一個目標或直接捨棄訊息，使得目標遺漏訊息，則會傳回 NotAvailable。

如果目標選擇不接受訊息，則會傳回 Declined。 如果目標選擇不接受此訊息，且將不會接受來自此來源的其他訊息，則會傳回 DecliningPermanently。

實作

OfferMessage(DataflowMessageHeader, TInput, ISourceBlock<TInput>, Boolean)

例外狀況

ArgumentException

messageHeader 無效。

或，如果隨著非 null source 一起提供，consumeToAccept 才能為 true。

適用於