Partilhar via


MessageQueue.MachineName Propriedade

Definição

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

Aplica-se a

Confira também