BatchBlock<T>.ITargetBlock<T>.OfferMessage Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Oferece uma mensagem ao ITargetBlock<TInput>, dando ao alvo a oportunidade de consumir ou adiar a mensagem.
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.DataflowMessageStatusFunction OfferMessage (messageHeader As DataflowMessageHeader, messageValue As T, source As ISourceBlock(Of T), consumeToAccept As Boolean) As DataflowMessageStatus Implements ITargetBlock(Of T).OfferMessageParâmetros
- messageHeader
- DataflowMessageHeader
Uma DataflowMessageHeader instância que representa o cabeçalho da mensagem oferecida.
- messageValue
- T
O valor da mensagem apresentada.
- source
- ISourceBlock<T>
A ISourceBlock<TOutput> oferta da mensagem. Isto pode ser nulo.
- consumeToAccept
- Boolean
Defina para true instruir o alvo a chamar ConsumeMessage(DataflowMessageHeader, ITargetBlock<TOutput>, Boolean) de forma síncrona durante a chamada para OfferMessage(DataflowMessageHeader, TInput, ISourceBlock<TInput>, Boolean), antes de devolver Accepted, para consumir a mensagem.
Devoluções
O estado da mensagem oferecida. Se a mensagem foi aceite pelo alvo, Accepted for devolvida e a fonte deixar de usar a mensagem oferecida, porque agora pertence ao alvo. Se a mensagem foi adiada pelo alvo, Postponed é devolvida como notificação de que o alvo pode posteriormente tentar consumir ou reservar a mensagem; entretanto, a fonte ainda detém a mensagem e pode oferecê-la a outros blocos.
Se o alvo teria adiado a mensagem, mas source era null, Declined é devolvido.
Se o alvo tentou aceitar a mensagem mas a perdeu devido à origem entregar a mensagem a outro alvo ou simplesmente a descartar, NotAvailable é devolvido.
Se o alvo optar por não aceitar a mensagem, Declined é devolvido. Se o alvo optar por não aceitar a mensagem e nunca aceitar outra mensagem desta fonte, DecliningPermanently é devolvido.
Implementações
Exceções
O messageHeader não é válido.
-ou- consumeToAccept só pode ser verdadeiro se for fornecido com um não-nulo source.