MessageQueue.MachineName Propiedad
Definición
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, setPublic Property MachineName As StringValor de propiedad
Nombre del equipo en el que se encuentra la cola. El valor predeterminado de Message Queuing es ".", es decir, el equipo local.
- Atributos
Excepciones
El valor de MachineName es null.
o bien
El nombre del equipo no es válido, posiblemente porque se ha utilizado una sintaxis incorrecta.
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 |
