MessageQueue.MachineName Propriedade

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 no qual a fila está localizada. O padrão do serviço de enfileiramento de mensagens é “.”, o computador local.

Atributos

BrowsableAttribute MessagingDescriptionAttribute

Exceções

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.

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.

Aplica-se a

Confira também

• QueueName
• Path
• FormatName
• GetPublicQueues()
• GetMessageQueueEnumerator()