MessageQueue.BasePriority Propriedade

Definição

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

Obtém ou define a prioridade base que o Enfileiramento de Mensagens usa para rotear mensagens de uma fila pública pela rede.

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

Valor da propriedade

Int16

A prioridade base única para todas as mensagens enviadas para a fila (pública). O padrão é zero (0).

Atributos

MessagingDescriptionAttribute

Exceções

ArgumentException

A prioridade base foi definida como um valor inválido.

MessageQueueException

Erro ao acessar um método do serviço de Enfileiramento de Mensagens.

Exemplos

O exemplo de código a seguir obtém e define o valor da propriedade de uma fila de BasePriority mensagens.

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

Comentários

A prioridade base de uma fila de mensagens especifica como uma mensagem a caminho dessa fila é tratada à medida que viaja pela rede. Você pode definir a BasePriority propriedade para conferir uma prioridade mais alta ou inferior a todas as mensagens enviadas para a fila especificada do que aquelas enviadas para outras filas. Definir essa propriedade modifica a fila de Enfileiramento de Mensagens. Portanto, quaisquer outras MessageQueue instâncias são afetadas pela alteração.

Uma fila de BasePriority mensagens não está relacionada à Priority propriedade de uma mensagem, que especifica a ordem na qual uma mensagem de entrada é colocada na fila.

BasePriority aplica-se somente a filas públicas cujos caminhos são especificados usando o nome do formato. A prioridade base de uma fila privada é sempre zero (0).

A tabela a seguir mostra se essa propriedade está disponível em vários modos de Grupo de Trabalho.

Modo de grupo de trabalho	Disponível
Computador local	Yes
Nome do computador local e do formato direto	Yes
Computador remoto	Não
Computador remoto e nome de formato direto	Não

Confira também

• FormatName