MessageQueue.Label Propriedade

Definição

Espaço de Nomes:
System.Messaging
Assemblagem:
System.Messaging.dll

Recebe 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 de Propriedade

String

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

Atributos
MessagingDescriptionAttribute

Exceções

ArgumentException

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

MessageQueueException

Ocorreu um erro ao aceder a um método de Fila de Mensagens.

Exemplos

O seguinte exemplo de código obtém e define o valor da propriedade de Label uma fila de 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);

Observações

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

A Label propriedade não precisa de ser única em todas as filas. No entanto, se várias filas partilham o mesmo Label, não pode usar o Send(Object) método para transmitir uma mensagem a todas elas. Se usar a sintaxe do rótulo da Path propriedade ao enviar a mensagem, será lançada uma exceção se o Label não for único.

A tabela seguinte mostra se esta propriedade está disponível em vários modos de Grupo de Trabalho.

Modo de grupo de trabalho Available
Computador local Yes
Computador local e nome do formato direto Yes
Computador remoto No
Computador remoto e nome do formato direto No

Aplica-se a

Ver também