ISourceBlock<TOutput>.ReserveMessage Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Chamado por um ITargetBlock<TInput> vinculado para reservar um DataflowMessageHeader oferecido anteriormente por este ISourceBlock<TOutput>.
public:
bool ReserveMessage(System::Threading::Tasks::Dataflow::DataflowMessageHeader messageHeader, System::Threading::Tasks::Dataflow::ITargetBlock<TOutput> ^ target);public bool ReserveMessage (System.Threading.Tasks.Dataflow.DataflowMessageHeader messageHeader, System.Threading.Tasks.Dataflow.ITargetBlock<out TOutput> target);abstract member ReserveMessage : System.Threading.Tasks.Dataflow.DataflowMessageHeader * System.Threading.Tasks.Dataflow.ITargetBlock<'Output> -> boolPublic Function ReserveMessage (messageHeader As DataflowMessageHeader, target As ITargetBlock(Of Out TOutput)) As BooleanParâmetros
- messageHeader
- DataflowMessageHeader
O DataflowMessageHeader da mensagem que é reservada.
- target
- ITargetBlock<TOutput>
O ITargetBlock<TInput> que reserva a mensagem.
Retornos
true se a mensagem foi reservada com êxito; caso contrário, false.
Exceções
O messageHeader não é válido.
O target é null.
Comentários
Somente ITargetBlock<TInput> instâncias vinculadas a essa ISourceBlock<TOutput> instância podem ser usadas ReserveMessage, e ela só deve ser usada para reservar DataflowMessageHeader instâncias oferecidas anteriormente por essa origem para o destino.
Se true for retornado, a ITargetBlock<TInput> mensagem deverá ser chamada ConsumeMessage posteriormente.ReleaseReservation Não fazer isso pode fazer com que a origem não possa propagar mais mensagens para esse ou outros destinos.
ReserveMessage não deve ser chamado enquanto o destino estiver mantendo bloqueios internos. Isso violará a hierarquia de bloqueio necessária para evitar deadlocks em uma rede de fluxo de dados.