TransformBlock<TInput,TOutput>.ITargetBlock<TInput>.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<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.DataflowMessageStatusFunction OfferMessage (messageHeader As DataflowMessageHeader, messageValue As TInput, source As ISourceBlock(Of TInput), consumeToAccept As Boolean) As DataflowMessageStatus Implements ITargetBlock(Of TInput).OfferMessageParâmetros
- messageHeader
- DataflowMessageHeader
Uma DataflowMessageHeader instância que representa o cabeçalho da mensagem oferecida.
- messageValue
- TInput
O valor da mensagem apresentada.
- source
- ISourceBlock<TInput>
A ISourceBlock<TOutput> oferta da mensagem. Isto pode ser null.
- consumeToAccept
- Boolean
true se o destino tiver de chamar ConsumeMessage(DataflowMessageHeader, ITargetBlock<TOutput>, Boolean) sincronizadamente durante a chamada para ITargetBlock<TInput>.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 sido adiado mas a fonte 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.