MessageQueue.FormatName MessageQueue.FormatName MessageQueue.FormatName MessageQueue.FormatName Property

Definición

Obtiene el nombre de cola único generado por Message Queuing al crear la cola.Gets the unique queue name that Message Queuing generated at the time of the queue's creation.

public:
 property System::String ^ FormatName { System::String ^ get(); };
[System.Messaging.MessagingDescription("MQ_FormatName")]
public string FormatName { get; }
member this.FormatName : string
Public ReadOnly Property FormatName As String

Valor de propiedad

Nombre de la cola, que es único en la red.The name for the queue, which is unique on the network.

Excepciones

Path no está establecido.The Path is not set.

O bien-or- Error al obtener acceso a un método de Message Queuing.An error occurred when accessing a Message Queuing method.

Ejemplos

En el ejemplo de código siguiente se muestra el valor de una cola de mensajes FormatName propiedad.The following code example displays the value of a message queue's FormatName property.

// Display the value of the queue's FormatName property.
Console.WriteLine("MessageQueue.FormatName: {0}", queue.FormatName);

Comentarios

El FormatName propiedad contiene el nombre de formato de la cola.The FormatName property contains the format name of the queue. Message Queue Server utiliza el nombre de formato para identificar qué cola para abrir y cómo tener acceso a él.Message Queuing uses the format name to identify which queue to open and how to access it. A diferencia de las características de una cola, el nombre de formato no es una propiedad de cola de aplicación de Message Queue Server, por lo que no se puede acceder a él a través de la herramienta de administración de Message Queue Server.Unlike most of a queue's characteristics, the format name is not a Message Queuing application queue property, so you cannot access it through the Message Queuing management tool. El nombre de formato es simplemente un nombre único para la cola, que Message Queuing genera cuando crea la cola o que la aplicación genera más tarde.The format name is simply a unique name for the queue, which Message Queuing generates when it creates the queue or which the application generates later.

Si especifica una ruta de acceso mediante la sintaxis de nombre de ruta de acceso (como myComputer\myQueue) en lugar de usar la sintaxis del nombre de formato al leer o escribir en la cola, el controlador de dominio principal (que usa Active Directory) convierte el Path en el asociadoFormatName antes de acceder a la cola.If you specify a path using the path name syntax (such as myComputer\myQueue) rather than using the format name syntax when you read or write to the queue, the primary domain controller (which uses Active Directory) translates the Path into the associated FormatName before accessing the queue. Si la aplicación está trabajando sin conexión, debe usar la sintaxis de nombre de formato; en caso contrario, el controlador de dominio principal no estará disponible para realizar la traducción de la ruta de acceso.If your application is working offline, you must use the format name syntax; otherwise, the primary domain controller will not be available to perform the path translation.

En la tabla siguiente se muestra si esta propiedad está disponible en los distintos modos de grupo de trabajo.The following table shows whether this property is available in various Workgroup modes.

Modo de grupo de trabajoWorkgroup mode DisponibleAvailable
Equipo localLocal computer Yes
Equipo local y el nombre de formato directoLocal computer and direct format name Yes
Equipo remotoRemote computer Yes
Equipo remoto y el nombre de formato directoRemote computer and direct format name Yes

Se aplica a

Consulte también: