ITargetBlock<TInput>.OfferMessage Yöntem

Tanım

Ad Alanı:

System.Threading.Tasks.Dataflow

Bütünleştirilmiş Kod:

System.Threading.Tasks.Dataflow.dll

hedefine ITargetBlock<TInput>iletiyi kullanma veya erteleme fırsatı veren bir ileti sunar.

public System.Threading.Tasks.Dataflow.DataflowMessageStatus OfferMessage (System.Threading.Tasks.Dataflow.DataflowMessageHeader messageHeader, TInput messageValue, System.Threading.Tasks.Dataflow.ISourceBlock<in TInput>? source, bool consumeToAccept);

abstract member OfferMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * 'Input * System.Threading.Tasks.Dataflow.ISourceBlock<'Input> * bool -> System.Threading.Tasks.Dataflow.DataflowMessageStatus

Public Function OfferMessage (messageHeader As DataflowMessageHeader, messageValue As TInput, source As ISourceBlock(Of In TInput), consumeToAccept As Boolean) As DataflowMessageStatus

Parametreler

messageHeader

DataflowMessageHeader

DataflowMessageHeader Sunulan iletinin üst bilgisini temsil eden örnek.

messageValue

TInput

Sunulan iletinin değeri.

source

ISourceBlock<TInput>

İletiyi ISourceBlock<TOutput> sunan. Bu null olabilir.

consumeToAccept

Boolean

true hedefine, iletiyi kullanmak için döndürmeden Acceptedönce çağrısı sırasında zaman uyumlu bir şekilde çağrılmasını OfferMessage(DataflowMessageHeader, TInput, ISourceBlock<TInput>, Boolean)ConsumeMessage(DataflowMessageHeader, ITargetBlock<TOutput>, Boolean) bildirmek için olarak ayarlayın.

Döndürülenler

DataflowMessageStatus

Sunulan iletinin durumu. İleti hedef tarafından kabul edildiyse döndürülür Accepted ve kaynak artık sunulan iletiyi kullanmamalıdır, çünkü artık hedefe aittir. İleti hedef tarafından ertelendiyse, Postponed hedefin daha sonra iletiyi tüketmeye veya ayırmaya çalışabileceğini belirten bir bildirim olarak döndürülür; bu arada, kaynak iletinin sahibi olmaya devam eder ve diğer bloklara sunabilir.

Hedef iletiyi başka bir şekilde ertelemiş olsa da kaynak ise nullDeclined döndürülür.

Hedef iletiyi kabul etmeye çalıştıysa ancak kaynağın iletiyi başka bir hedefe teslim etme veya yalnızca atma nedeniyle kaçırması durumunda döndürülür NotAvailable .

Hedef iletiyi kabul etmemeyi seçerse, Declined döndürülür. Hedef iletiyi kabul etmemeyi seçerse ve bu kaynaktan başka bir iletiyi asla kabul etmezse, DecliningPermanently döndürülür.

Özel durumlar

ArgumentException

messageHeader geçerli değil.

-or- consumeToAccept yalnızca null sourceolmayan bir ile sağlanıyorsa doğru olabilir.