MessageQueue.Label Property

Definition

Obtém ou define a descrição da fila.Gets or sets the queue description.

public:
 property System::String ^ Label { System::String ^ get(); void set(System::String ^ value); };
[System.Messaging.MessagingDescription("MQ_Label")]
public string Label { get; set; }
member this.Label : string with get, set
Public Property Label As String

Property Value

String

O rótulo para a fila de mensagens.The label for the message queue. O padrão é uma cadeia de caracteres vazia ("").The default is an empty string ("").

Attributes

Exceptions

O rótulo foi definido como um valor inválido.The label was set to an invalid value.

Erro ao acessar um método do serviço de Enfileiramento de Mensagens.An error occurred when accessing a Message Queuing method.

Examples

O exemplo de código a seguir obtém e define o valor da propriedade Label de uma fila de mensagens.The following code example gets and sets the value of a message queue's Label property.

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

Remarks

O comprimento máximo de um rótulo de fila de mensagens é de 124 caracteres.The maximum length of a message queue label is 124 characters.

A propriedade Label não precisa ser exclusiva em todas as filas.The Label property does not need to be unique across all queues. No entanto, se várias filas compartilharem a mesma Label, você não poderá usar o método Send(Object) para difundir uma mensagem a todas elas.However, if multiple queues share the same Label, you cannot use the Send(Object) method to broadcast a message to all of them. Se você usar a sintaxe de rótulo para a propriedade Path ao enviar a mensagem, uma exceção será gerada se o Label não for exclusivo.If you use the label syntax for the Path property when you send the message, an exception will be thrown if the Label is not unique.

A tabela a seguir mostra se essa propriedade está disponível em vários modos de grupo de trabalho.The following table shows whether this property is available in various Workgroup modes.

Modo de grupo de trabalhoWorkgroup mode DisponívelAvailable
Computador localLocal computer SimYes
Computador local e nome de formato diretoLocal computer and direct format name SimYes
Computador remotoRemote computer NãoNo
Computador remoto e nome de formato diretoRemote computer and direct format name NãoNo

Applies to

See also