MessageQueue.BasePriority MessageQueue.BasePriority MessageQueue.BasePriority MessageQueue.BasePriority Property

Definición

Obtiene o establece la prioridad básica que Message Queuing utiliza para enrutar los mensajes de una cola pública a través de la red.Gets or sets the base priority Message Queuing uses to route a public queue's messages over the network.

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

Valor de propiedad

Prioridad básica única para todos los mensajes enviados a la cola (pública).The single base priority for all messages sent to the (public) queue. El valor predeterminado es cero (0).The default is zero (0).

Excepciones

La prioridad básica se estableció en un valor incorrecto.The base priority was set to an invalid value.

Error al obtener acceso a un método de Message Queuing.An error occurred when accessing a Message Queuing method.

Ejemplos

En el ejemplo de código siguiente se obtiene y se establece el valor de BasePriority la propiedad de una cola de mensajes.The following code example gets and sets the value of a message queue's BasePriority property.

// 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);

Comentarios

La prioridad base de una cola de mensajes especifica cómo se trata un mensaje en la ruta a esa cola mientras viaja por la red.A message queue's base priority specifies how a message en route to that queue is treated as it travels through the network. Puede establecer la BasePriority propiedad para que conceda una prioridad mayor o menor a todos los mensajes enviados a la cola especificada que los enviados a otras colas.You can set the BasePriority property to confer a higher or lower priority to all messages sent to the specified queue than those sent to other queues. Al establecer esta propiedad, se modifica la cola de Message Queue Server.Setting this property modifies the Message Queuing queue. Por lo tanto, MessageQueue cualquier otra instancia se ve afectada por el cambio.Therefore, any other MessageQueue instances are affected by the change.

Una cola BasePriority de mensajes no está relacionada con Priority la propiedad de un mensaje, que especifica el orden en el que un mensaje entrante se coloca en la cola.A message queue's BasePriority is not related to the Priority property of a message, which specifies the order in which an incoming message is placed in the queue.

BasePrioritysolo se aplica a las colas públicas cuyas rutas de acceso se especifican con el nombre de formato.BasePriority applies only to public queues whose paths are specified using the format name. La prioridad base de una cola privada siempre es cero (0).The base priority of a private queue is always zero (0).

En la tabla siguiente se muestra si esta propiedad está disponible en varios modos de grupo de trabajo.The following table shows whether this property is available in various Workgroup modes.

Modo de grupo de trabajoWorkgroup mode DisponibleAvailable
Equipo localLocal computer Yes
Equipo local y nombre de formato directoLocal computer and direct format name Yes
Equipo remotoRemote computer NoNo
Equipo remoto y nombre de formato directoRemote computer and direct format name NoNo

Se aplica a

Consulte también: