MessageQueue.MachineName Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Messaging
Ensamblado:
System.Messaging.dll

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

Consulte también