WriteOnceBlock<T>.ITargetBlock<T>.OfferMessage Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Oferuje komunikat do ITargetBlock<TInput>elementu , dając docelową możliwość korzystania lub odroczenia komunikatu.
virtual System::Threading::Tasks::Dataflow::DataflowMessageStatus System.Threading.Tasks.Dataflow.ITargetBlock<T>.OfferMessage(System::Threading::Tasks::Dataflow::DataflowMessageHeader messageHeader, T messageValue, System::Threading::Tasks::Dataflow::ISourceBlock<T> ^ source, bool consumeToAccept) = System::Threading::Tasks::Dataflow::ITargetBlock<T>::OfferMessage;
System.Threading.Tasks.Dataflow.DataflowMessageStatus ITargetBlock<T>.OfferMessage (System.Threading.Tasks.Dataflow.DataflowMessageHeader messageHeader, T messageValue, System.Threading.Tasks.Dataflow.ISourceBlock<T> source, bool consumeToAccept);
abstract member System.Threading.Tasks.Dataflow.ITargetBlock<T>.OfferMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * 'T * System.Threading.Tasks.Dataflow.ISourceBlock<'T> * bool -> System.Threading.Tasks.Dataflow.DataflowMessageStatus
override this.System.Threading.Tasks.Dataflow.ITargetBlock<T>.OfferMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * 'T * System.Threading.Tasks.Dataflow.ISourceBlock<'T> * bool -> System.Threading.Tasks.Dataflow.DataflowMessageStatus
Function OfferMessage (messageHeader As DataflowMessageHeader, messageValue As T, source As ISourceBlock(Of T), consumeToAccept As Boolean) As DataflowMessageStatus Implements ITargetBlock(Of T).OfferMessage
Parametry
- messageHeader
- DataflowMessageHeader
DataflowMessageHeader Wystąpienie reprezentujące nagłówek oferowanego komunikatu.
- messageValue
- T
Wartość oferowanego komunikatu.
- source
- ISourceBlock<T>
Oferta ISourceBlock<TOutput> wiadomości. Może to być null
.
- consumeToAccept
- Boolean
Ustaw wartość na , aby true
poinstruować element docelowy, aby ConsumeMessage(DataflowMessageHeader, ITargetBlock<TOutput>, Boolean) wywołał synchronicznie podczas wywołania OfferMessage(DataflowMessageHeader, TInput, ISourceBlock<TInput>, Boolean)metody , przed zwróceniem Acceptedelementu w celu korzystania z komunikatu.
Zwraca
Stan oferowanej wiadomości. Jeśli komunikat został zaakceptowany przez element docelowy, Accepted jest zwracany, a źródło nie powinno już używać oferowanego komunikatu, ponieważ jest teraz własnością obiektu docelowego. Jeśli komunikat został odroczony przez element docelowy, Postponed jest zwracany jako powiadomienie, że element docelowy może później podjąć próbę użycia lub zarezerwować komunikat; w międzyczasie źródło nadal jest właścicielem wiadomości i może zaoferować ją innym blokom.
Jeśli element docelowy w przeciwnym razie odroczyłby komunikat, ale source
był null
, Declined jest zwracany.
Jeśli element docelowy próbował zaakceptować komunikat, ale go nieodebrał z powodu źródła dostarczającego komunikat do innego miejsca docelowego lub po prostu go odrzucić, NotAvailable jest zwracany.
Jeśli element docelowy nie zaakceptował komunikatu, Declined zostanie zwrócony. Jeśli element docelowy nie zaakceptował wiadomości i nigdy nie zaakceptuje innego komunikatu z tego źródła, DecliningPermanently zostanie zwrócony.
Implementuje
Wyjątki
Wartość jest nieprawidłowa messageHeader
.
-or- consumeToAccept
może mieć wartość true tylko w przypadku podania wartości innej niż null source
.