MessageQueue.FormatName Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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
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 |