MessageReceiver.PrefetchCount Propriedade

Definição

Namespace:

Microsoft.Azure.ServiceBus.Core

Assembly:

Microsoft.Azure.ServiceBus.dll

Pacote:

Microsoft.Azure.ServiceBus v5.2.0

Origem:

MessageReceiver.cs

A pré-busca acelera o fluxo de mensagens com o objetivo de ter uma mensagem prontamente disponível para recuperação local quando e antes que o aplicativo solicite uma usando Receive. Definir um valor diferente de zero pré-busca o número de mensagens PrefetchCount. Definir o valor como zero desativa a pré-busca. Assume o padrão de 0.

public int PrefetchCount { get; set; }

member this.PrefetchCount : int with get, set

Public Property PrefetchCount As Integer

Valor da propriedade

Int32

Implementações

PrefetchCount

Comentários

Quando o Prefetch estiver habilitado, o receptor adquirirá silenciosamente mais mensagens, até o limite de PrefetchCount, do que o que o aplicativo solicita imediatamente. Uma única chamada inicial de Receive/ReceiveAsync, portanto, adquirirá uma mensagem para consumo imediato que será retornada assim que disponível, e o cliente prosseguirá para adquirir mais mensagens para preencher o buffer de pré-busca em segundo plano.

Embora as mensagens estejam disponíveis no buffer de pré-busca, todas as chamadas ReceiveAsync subsequentes serão atendidas imediatamente do buffer e o buffer será reabastecido em segundo plano à medida que o espaço ficar disponível. Se não houver mensagens disponíveis para entrega, a operação de recebimento esvaziará o buffer e aguardará ou bloqueará conforme o esperado.

A pré-busca também funciona de forma equivalente com as RegisterMessageHandler(Func<Message,CancellationToken,Task>, Func<ExceptionReceivedEventArgs,Task>) APIs.

Atualizações para esse valor entrarão em vigor na próxima chamada de recebimento para o serviço.