MessageQueue.FormatName Propriedade

Definição

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

Obtém o nome de fila exclusivo que o Enfileiramento de Mensagens gerou no momento da criação da fila.

public:
 property System::String ^ FormatName { System::String ^ get(); };

[System.Messaging.MessagingDescription("MQ_FormatName")]
public string FormatName { get; }

[<System.Messaging.MessagingDescription("MQ_FormatName")>]
member this.FormatName : string

Public ReadOnly Property FormatName As String

Valor da propriedade

String

O nome da fila, que é exclusivo na rede.

Atributos

MessagingDescriptionAttribute

Exceções

MessageQueueException

O Path não foi definido.

- ou -

Erro ao acessar um método do serviço de Enfileiramento de Mensagens.

Exemplos

O exemplo de código a seguir exibe o valor da propriedade de uma fila de FormatName mensagens.

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

Comentários

A FormatName propriedade contém o nome do formato da fila. O Enfileiramento de Mensagens usa o nome do formato para identificar qual fila abrir e como acessá-la. Ao contrário da maioria das características de uma fila, o nome do formato não é uma propriedade de fila de aplicativo de Enfileiramento de Mensagens, portanto, você não pode acessá-la por meio da ferramenta de gerenciamento de Enfileiramento de Mensagens. O nome do formato é simplesmente um nome exclusivo para a fila, que o Enfileiramento de Mensagens gera quando cria a fila ou que o aplicativo gera posteriormente.

Se você especificar um caminho usando a sintaxe do nome do caminho (como myComputer\myQueue) em vez de usar a sintaxe de nome de formato ao ler ou gravar na fila, o controlador de domínio primário (que usa o Active Directory) traduzirá o Path para o associado FormatName antes de acessar a fila. Se o aplicativo estiver funcionando offline, você deverá usar a sintaxe de nome de formato; caso contrário, o controlador de domínio primário não estará disponível para executar a tradução de caminho.

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	Yes

Confira também

• Path
• Label
• MessageQueue