ISourceBlock<TOutput>.ConsumeMessage Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Chiamato da un oggetto collegato ITargetBlock<TInput> per accettare e utilizzare un DataflowMessageHeader oggetto offerto in precedenza da questo ISourceBlock<TOutput>oggetto .
public TOutput ConsumeMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader messageHeader, System.Threading.Tasks.Dataflow.ITargetBlock<out TOutput> target, out bool messageConsumed);
public TOutput? ConsumeMessage(System.Threading.Tasks.Dataflow.DataflowMessageHeader messageHeader, System.Threading.Tasks.Dataflow.ITargetBlock<out TOutput> target, out bool messageConsumed);
abstract member ConsumeMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * System.Threading.Tasks.Dataflow.ITargetBlock<'Output> * bool -> 'Output
Public Function ConsumeMessage (messageHeader As DataflowMessageHeader, target As ITargetBlock(Of Out TOutput), ByRef messageConsumed As Boolean) As TOutput
Parametri
- messageHeader
- DataflowMessageHeader
Oggetto DataflowMessageHeader del messaggio utilizzato.
- target
- ITargetBlock<TOutput>
Oggetto ITargetBlock<TInput> che utilizza il messaggio.
- messageConsumed
- Boolean
true se il messaggio è stato utilizzato correttamente; in caso contrario, false.
Valori restituiti
Valore del messaggio utilizzato. Ciò può corrispondere a un'istanza diversa DataflowMessageHeader rispetto a quella precedentemente riservata e passata come messageHeader a ConsumeMessage(DataflowMessageHeader, ITargetBlock<TOutput>, Boolean). L'utilizzo ITargetBlock<TInput> deve usare il valore restituito anziché il valore passato come messageValue tramite OfferMessage(DataflowMessageHeader, TInput, ISourceBlock<TInput>, Boolean).
Se il messaggio richiesto non è disponibile, il valore restituito sarà Null.
Eccezioni
MessageHeader non valido.
La destinazione è null.
Commenti
Solo ITargetBlock<TInput> le istanze collegate a questa ISourceBlock<TOutput> istanza possono usare ConsumeMessagee devono essere usate solo per utilizzare DataflowMessageHeader le istanze offerte in precedenza da questa origine alla destinazione.