Partilhar via


MessageQueue.Label Propriedade

Definição

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

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

Atributos

Exceções

O rótulo foi definido como um valor inválido.

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

Aplica-se a

Confira também