MessageQueue.MachineName Propriedade

Definição

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

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, set

Public Property MachineName As String

Valor da propriedade

String

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

ArgumentException

O MachineName é null. - ou -

O nome do computador não é válido, possivelmente porque a sintaxe está incorreta.

MessageQueueException

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

Confira também

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