MessageQueue.FormatName Propriété

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

Valeur de propriété

Nom de la file d'attente. Il s'agit d'un nom unique sur le réseau.

Attributs

MessagingDescriptionAttribute

Exceptions

Exemples

L’exemple de code suivant affiche la valeur de la propriété d’une file d’attente de FormatName messages.

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

Remarques

La FormatName propriété contient le nom de format de la file d’attente. Message Queuing utilise le nom de format pour identifier la file d’attente à ouvrir et comment y accéder. Contrairement à la plupart des caractéristiques d’une file d’attente, le nom de format n’est pas une propriété de file d’attente d’application Message Queuing. Vous ne pouvez donc pas y accéder via l’outil de gestion Message Queuing. Le nom de format est simplement un nom unique pour la file d’attente, que Message Queuing génère lorsqu’il crée la file d’attente ou que l’application génère ultérieurement.

Si vous spécifiez un chemin à l’aide de la syntaxe de nom de chemin d’accès (par exemple myComputer\myQueue) plutôt que de la syntaxe de nom de format lorsque vous lisez ou écrivez dans la file d’attente, le contrôleur de domaine principal (qui utilise Active Directory) traduit en Path associé FormatName avant d’accéder à la file d’attente. Si votre application fonctionne hors connexion, vous devez utiliser la syntaxe du nom de format ; sinon, le contrôleur de domaine principal ne sera pas disponible pour effectuer la traduction du chemin d’accès.

Le tableau suivant indique si cette propriété est disponible dans différents modes de groupe de travail.

S’applique à

Voir aussi

• Path
• Label
• MessageQueue