MessageQueue.MachineName Propiedad

Referencia

Definición

Espacio de nombres:: System.Messaging

Ensamblado:: System.Messaging.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Obtiene o establece el nombre del equipo en el que se encuentra la cola de Message Queuing.

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 de propiedad

String

Nombre del equipo en el que se encuentra la cola. El valor predeterminado de Message Queuing es ".", es decir, el equipo local.

Atributos: BrowsableAttribute MessagingDescriptionAttribute

Excepciones

ArgumentException

El valor de MachineName es null. o bien

El nombre del equipo no es válido, posiblemente porque se ha utilizado una sintaxis incorrecta.

MessageQueueException

Error al obtener acceso a un método de Message Queuing.

Ejemplos

En el ejemplo de código siguiente se obtiene y se establece el valor de la propiedad de una cola de MachineName mensajes.

// 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);

Comentarios

MachineName es un componente integral de la sintaxis de nombre descriptivo de la cola Path. En la tabla siguiente se muestra la sintaxis que debe usar para una cola de un tipo especificado cuando desee identificar la ruta de acceso de la cola con su nombre descriptivo.

Tipo de cola	Syntax
Cola pública	`MachineName`\`QueueName`
Cola privada	`MachineName`\`Private$`\`QueueName`
Cola de diario	`MachineName`\`QueueName`\`Journal$`
Cola de diario de la máquina	`MachineName`\`Journal$`
Cola de mensajes fallidos de la máquina	`MachineName`\`Deadletter$`
Cola de mensajes fallidos transaccionales de la máquina	`MachineName`\`XactDeadletter$`

Use "." para el equipo local al especificar .MachineName Solo se reconoce el nombre del equipo para esta propiedad, por ejemplo, Server0. La MachineName propiedad no admite el formato de dirección IP.

Si define en Path términos de MachineName, la aplicación produce una excepción al trabajar sin conexión porque el controlador de dominio es necesario para la traducción de la ruta de acceso. Por lo tanto, debe usar para FormatName la Path sintaxis al trabajar sin conexión.

Las MachineNamepropiedades , Pathy QueueName están relacionadas. Cambiar la MachineName propiedad hace que la Path propiedad cambie. Se crea a partir de los nuevos MachineName y .QueueName Path Al cambiar (por ejemplo, para usar la sintaxis de nombre de formato), se restablecen las MachineName propiedades y QueueName para hacer referencia a la nueva cola. Si la QueueName propiedad está vacía, Path se establece en la cola de Journal del equipo que especifique.

En la tabla siguiente se muestra si esta propiedad está disponible en varios modos de grupo de trabajo.

Modo de grupo de trabajo	Disponible
Equipo local	Sí
Equipo local y nombre de formato directo	Sí
Equipo remoto	Sí
Equipo remoto y nombre de formato directo	No

Se aplica a

Compartir vía