Compartir a través de


MessageQueue.FormatName Propiedad

Definición

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

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 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
Equipo local y nombre de formato directo
Equipo remoto
Equipo remoto y nombre de formato directo

Se aplica a

Consulte también