MessageQueue.QueueName Propriedade

Definição

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

Obtém ou define o nome amigável que identifica a fila.

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

[System.ComponentModel.Browsable(false)]
[System.Messaging.MessagingDescription("MQ_QueueName")]
public string QueueName { get; set; }

[<System.ComponentModel.Browsable(false)>]
[<System.Messaging.MessagingDescription("MQ_QueueName")>]
member this.QueueName : string with get, set

Public Property QueueName As String

Valor da propriedade

String

O nome que identifica a fila referenciada por essa MessageQueue. O valor não pode ser null.

Atributos

BrowsableAttribute MessagingDescriptionAttribute

Exceções

ArgumentException

O nome da fila é null.

Exemplos

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

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

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

Comentários

Você pode combinar o QueueName com o MachineName para criar um nome amigável Path para a fila. A sintaxe da variação de nome amigável da Path propriedade depende do tipo de fila, conforme mostrado na tabela a seguir.

Tipo de fila	Sintaxe
Fila pública	MachineName\QueueName
Fila privada	MachineName\Private$\QueueName
fila de Diário	MachineName\QueueName\Journal$

Use "." para representar o computador local.

Alterar a QueueName propriedade afeta a Path propriedade . Se você definir o QueueName sem definir a MachineName propriedade, a Path propriedade se tornará .\QueueName. Caso contrário, o Path se tornará\MachineNameQueueName .

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	Yes
Computador remoto e nome de formato direto	Não

Confira também

• Path
• MachineName