MessageQueue.FormatName Propriedade

Definição

Recebe o nome único da fila que a Message Queuing gerou na altura 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 de Propriedade

O nome da fila, que é único na rede.

Atributos

Exceções

O Path não está definido.

-ou-

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

Exemplos

O seguinte exemplo de código mostra o valor da propriedade de FormatName uma fila de mensagens.

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

Observações

A FormatName propriedade contém o nome do formato da fila. A Fila de Mensagens usa o nome do formato para identificar qual fila abrir e como aceder a ela. Ao contrário da maioria das características de uma fila, o nome do formato não é propriedade da fila da aplicação Message Queuing, pelo que não pode aceder a ela através da ferramenta de gestão de Message Queuing. O nome do formato é simplesmente um nome único para a fila, que a Message Queuing gera ao criar a fila ou que a aplicação gera posteriormente.

Se especificar um caminho usando a sintaxe do nome do caminho (como myComputer\myQueue) em vez de usar a sintaxe do nome do formato ao ler ou escrever na fila, o controlador de domínio primário (que usa Active Directory) traduz o Path para o FormatName associado antes de aceder à fila. Se a sua aplicação estiver a funcionar offline, deve usar a sintaxe do nome do formato; caso contrário, o controlador de domínio principal não estará disponível para realizar a tradução de caminhos.

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 Yes
Computador remoto e nome do formato direto Yes

Aplica-se a

Ver também