Partager via


MessageReceiver.PrefetchCount Propriété

Définition

La prérécupération accélère le flux de message en visant à avoir un message facilement disponible pour une récupération locale lorsque et avant que l’application en demande un à l’aide de Receive. La définition d’une valeur différente de zéro préréfète le nombre de messages PrefetchCount. La définition de la valeur zéro désactive la prérécupération. La valeur par défaut est 0.

public int PrefetchCount { get; set; }
member this.PrefetchCount : int with get, set
Public Property PrefetchCount As Integer

Valeur de propriété

Implémente

Remarques

Lorsque la prérécupération est activée, le récepteur acquiert silencieusement plus de messages, jusqu’à la limite prefetchCount, que ce que l’application demande immédiatement. Un seul appel Receive/ReceiveAsync initial acquiert donc un message pour une consommation immédiate qui sera retourné dès que disponible, et le client procédera à l’acquisition de messages supplémentaires pour remplir la mémoire tampon de prérécupération en arrière-plan.

Bien que les messages soient disponibles dans la mémoire tampon de prérécupération, tous les appels ReceiveAsync suivants sont immédiatement satisfaits à partir de la mémoire tampon, et la mémoire tampon est réapprovisionnée en arrière-plan à mesure que de l’espace devient disponible. Si aucun message n’est disponible pour remise, l’opération de réception draine la mémoire tampon, puis attend ou se bloque comme prévu.

La prérécupération fonctionne également de manière équivalente avec les RegisterMessageHandler(Func<Message,CancellationToken,Task>, Func<ExceptionReceivedEventArgs,Task>) API.

Mises à jour à cette valeur prennent effet lors de l’appel de réception suivant au service.

S’applique à