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 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, set
Public Property MachineName As String
Valor da propriedade
O nome do computador em que a fila está localizada. O padrã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.
Ocorreu um erro ao acessar um método 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
É 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ários | MachineName\QueueName\Journal$ |
| Fila de diários do computador | MachineName\Journal$ |
| Fila de mensagens mortas do computador | MachineName\Deadletter$ |
| Fila de mensagens mortas transacionais 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 os Path termos do aplicativo, o aplicativo gerará uma exceção ao trabalhar offline porque o controlador de domínio é necessário para a tradução de MachineNamecaminho. Portanto, você deve usar a FormatName sintaxe ao Path trabalhar offline.
As MachineNamepropriedades e QueueName as Pathpropriedades estão relacionadas. Alterar a MachineName propriedade faz com que a Path propriedade seja alterada. Ele é construído a partir do novo MachineName e do QueueName. Alterar a Path (por exemplo, para usar a sintaxe de nome de formato) redefine as propriedades e QueueName as MachineName propriedades para se referir à nova fila. Se a QueueName propriedade estiver vazia, a Path opção será definida 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 | Sim |
| Nome do computador local e do formato direto | Sim |
| Computador remoto | Sim |
| Computador remoto e nome do formato direto | No |