MessageQueue.FormatName 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 el nombre de cola único generado por Message Queuing al crear la cola.
public:
property System::String ^ FormatName { System::String ^ get(); };[System.Messaging.MessagingDescription("MQ_FormatName")]
public string FormatName { get; }[<System.Messaging.MessagingDescription("MQ_FormatName")>]
member this.FormatName : stringPublic ReadOnly Property FormatName As StringValor de propiedad
Nombre de la cola, que es único en la red.
- Atributos
Excepciones
Path no está establecido.
o bien Error al obtener acceso a un método de Message Queuing.
Ejemplos
En el ejemplo de código siguiente se muestra el valor de la propiedad de una cola de FormatName mensajes.
// Display the value of the queue's FormatName property.
Console.WriteLine("MessageQueue.FormatName: {0}", queue.FormatName);
Comentarios
La FormatName propiedad contiene el nombre de formato de la cola. Message Queuing usa el nombre de formato para identificar qué cola abrir y cómo acceder a ella. A diferencia de la mayoría de las características de una cola, el nombre de formato no es una propiedad de cola de la aplicación Message Queuing, por lo que no se puede acceder a ella a través de la herramienta de administración de Message Queuing. El nombre del formato es simplemente un nombre único para la cola, que Message Queuing genera cuando crea la cola o la que genera la aplicación más adelante.
Si especifica una ruta de acceso mediante la sintaxis de nombre de ruta de acceso (por myComputer\myQueueejemplo, ) en lugar de usar la sintaxis de nombre de formato al leer o escribir en la cola, el controlador de dominio principal (que usa Active Directory) convierte en Path el asociado FormatName antes de acceder a la cola. Si la aplicación funciona sin conexión, debe usar la sintaxis de nombre de formato; de lo contrario, el controlador de dominio principal no estará disponible para realizar la traducción de la ruta de acceso.
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 | Sí |