MessageQueue.MachineName 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.
Obtém ou define o nome do computador onde está localizada a fila de Fila de Mensagens.
public:
property System::String ^ MachineName { System::String ^ get(); void set(System::String ^ value); };[System.ComponentModel.Browsable(false)]
[System.Messaging.MessagingDescription("MQ_MachineName")]
public string MachineName { get; set; }[<System.ComponentModel.Browsable(false)>]
[<System.Messaging.MessagingDescription("MQ_MachineName")>]
member this.MachineName : string with get, setPublic Property MachineName As StringValor de Propriedade
O nome do computador onde a fila está localizada. O padrão da Fila de Mensagens é ".", o computador local.
- Atributos
Exceções
O MachineName é null.
-ou-
O nome do computador não é válido, possivelmente porque a sintaxe está incorreta.
Ocorreu um erro ao aceder a um método de Fila de Mensagens.
Exemplos
O seguinte exemplo de código obtém e define o valor da propriedade de MachineName uma fila de mensagens.
// Set the queue's MachineName property value to the name of the local
// computer.
queue.MachineName = ".";
// Display the new value of the queue's MachineName property.
Console.WriteLine("MessageQueue.MachineName: {0}", queue.MachineName);
Observações
O MachineName é um componente integral da sintaxe de nomes amigáveis da fila Path. A tabela seguinte mostra a sintaxe que deve usar para uma fila de um tipo especificado quando quiser identificar o caminho da fila usando o seu nome amigável.
| Tipo de fila | Sintaxe |
|---|---|
| Fila pública | MachineName\QueueName |
| Fila privada | MachineName\Private$\QueueName |
| Fila de diário | MachineName\QueueName\Journal$ |
| Fila de diário da máquina | MachineName\Journal$ |
| Fila de letra morta automática | MachineName\Deadletter$ |
| Fila de letras mortas transacionais de máquina | MachineName\XactDeadletter$ |
Use "." para o computador local ao especificar o MachineName. Apenas o nome do computador é reconhecido para esta propriedade, por exemplo, Server0. A MachineName propriedade não suporta o formato de endereço IP.
Se definir o Path em termos do MachineName, a aplicação lança uma exceção ao trabalhar offline porque o controlador de domínio é necessário para a tradução de caminhos. Por isso, deve usar a FormatName sintaxe for Path for ao trabalhar offline.
As MachineNamepropriedades , Path, e QueueName estão relacionadas. Mudar a MachineName propriedade faz com que a Path propriedade mude. É construído a partir do novo MachineName e do QueueName. Alterar ( Path por exemplo, para usar a sintaxe do nome do formato) reinicia as MachineName propriedades e QueueName para se referirem à nova fila. Se a QueueName propriedade estiver vazia, o Path é definido para a fila de diário do computador que especificar.
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 | No |