MessageQueue.FormatName 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 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 : string

Public ReadOnly Property FormatName As String

Valor de propiedad

String

Nombre de la cola, que es único en la red.

Atributos: MessagingDescriptionAttribute

Excepciones

MessageQueueException

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 del formato no es una propiedad de cola de la aplicación Message Queuing, por lo que no puede acceder a ella a través de la herramienta de administración 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 la aplicación genera 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 el Path en el asociado FormatName antes de acceder a la cola. Si la aplicación está trabajando 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í

Se aplica a

Compartir a través de