MessageQueue.BasePriority Propriété

Définition

Obtient ou définit la priorité de base utilisée par Message Queuing pour acheminer les messages d'une file d'attente publique sur le réseau.

public:
 property short BasePriority { short get(); void set(short value); };
[System.Messaging.MessagingDescription("MQ_BasePriority")]
public short BasePriority { get; set; }
[<System.Messaging.MessagingDescription("MQ_BasePriority")>]
member this.BasePriority : int16 with get, set
Public Property BasePriority As Short

Valeur de propriété

Priorité de base unique pour tous les messages envoyés à la file d'attente (publique). La valeur par défaut est zéro (0).

Attributs

Exceptions

La valeur de la priorité de base est non valide.

Une erreur s'est produite lors de l'accès à une méthode Message Queuing.

Exemples

L’exemple de code suivant obtient et définit la valeur de la propriété d’une file d’attente de BasePriority messages.

// Set the queue's BasePriority property value.
queue.BasePriority = 10;

// Display the new value of the queue's BasePriority property.
Console.WriteLine("MessageQueue.BasePriority: {0}", queue.BasePriority);

Remarques

La priorité de base d’une file d’attente de messages spécifie la façon dont un message en route vers cette file d’attente est traité à mesure qu’il transite par le réseau. Vous pouvez définir la BasePriority propriété pour accorder une priorité supérieure ou inférieure à tous les messages envoyés à la file d’attente spécifiée par rapport à ceux envoyés à d’autres files d’attente. La définition de cette propriété modifie la file d’attente Message Queuing. Par conséquent, toutes les autres MessageQueue instances sont affectées par la modification.

Une file d’attente de messages n’est BasePriority pas liée à la Priority propriété d’un message, qui spécifie l’ordre dans lequel un message entrant est placé dans la file d’attente.

BasePriority s’applique uniquement aux files d’attente publiques dont les chemins d’accès sont spécifiés à l’aide du nom de format. La priorité de base d’une file d’attente privée est toujours zéro (0).

Le tableau suivant indique si cette propriété est disponible dans différents modes de groupe de travail.

Mode groupe de travail Disponible
Ordinateur local Oui
Ordinateur local et nom de format direct Oui
Ordinateur distant Non
Ordinateur distant et nom de format direct Non

S’applique à

Voir aussi