MessageQueue.Label Propriedade

Definição

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

Obtém ou define a descrição da fila.

public:
 property System::String ^ Label { System::String ^ get(); void set(System::String ^ value); };

[System.Messaging.MessagingDescription("MQ_Label")]
public string Label { get; set; }

[<System.Messaging.MessagingDescription("MQ_Label")>]
member this.Label : string with get, set

Public Property Label As String

Valor da propriedade

String

O rótulo para a fila de mensagens. O padrão é uma cadeia de caracteres vazia ("").

Atributos

MessagingDescriptionAttribute

Exceções

ArgumentException

O rótulo foi definido 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 Label mensagens.

// Set the queue's Label property value.
queue.Label = "Example Queue";

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

Comentários

O comprimento máximo de um rótulo de fila de mensagens é de 124 caracteres.

A Label propriedade não precisa ser exclusiva em todas as filas. No entanto, se várias filas compartilharem o mesmo Label, você não poderá usar o Send(Object) método para transmitir uma mensagem para todas elas. Se você usar a sintaxe de rótulo para a Path propriedade ao enviar a mensagem, uma exceção será gerada se o Label não for exclusivo.

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

• Path
• FormatName
• GetPublicQueues()
• GetMessageQueueEnumerator()