MessageQueue.MachineName Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define o nome do computador em que a fila do serviço de enfileiramento de mensagens está localizada.
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 da propriedade
O nome do computador no qual a fila está localizada. O padrão do serviço de enfileiramento 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.
Erro ao acessar um método do serviço de Enfileiramento de Mensagens.
Exemplos
O exemplo de código a seguir obtém e define o valor da propriedade de uma fila de MachineName 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);
Comentários
O MachineName é um componente integral da sintaxe de nome amigável da fila Path. A tabela a seguir mostra a sintaxe que você deve usar para uma fila de um tipo especificado quando quiser identificar o caminho da fila usando 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 do diário do computador | MachineName\Journal$ |
| Fila de mensagens mortas do computador | MachineName\Deadletter$ |
| Fila de mensagens mortas transacional do computador | MachineName\XactDeadletter$ |
Use "." para o computador local ao especificar o MachineName. Somente o nome do computador é reconhecido para essa propriedade, por exemplo, Server0. A MachineName propriedade não dá suporte ao formato de endereço IP.
Se você definir o Path em termos do MachineName, o aplicativo gerará uma exceção ao trabalhar offline porque o controlador de domínio é necessário para a tradução de caminho. Portanto, você deve usar o FormatName para a Path sintaxe ao trabalhar offline.
As MachineNamepropriedades , Pathe QueueName estão relacionadas. Alterar a MachineName propriedade faz com que a Path propriedade seja alterada. Ele é criado a partir do novo MachineName e do QueueName. Alterar o Path (por exemplo, para usar a sintaxe de nome de formato) redefine as MachineName propriedades e QueueName para fazer referência à nova fila. Se a QueueName propriedade estiver vazia, o Path será definido como a fila Diário do computador especificado.
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 |
