Freigeben über

MessageQueue.FormatName Eigenschaft

Definition

Namespace:
System.Messaging
Assembly:
System.Messaging.dll

Ruft den eindeutigen Warteschlangennamen ab, den Message Queuing zum Zeitpunkt der Erstellung der Warteschlange generiert hat.

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

Eigenschaftswert

String

Der Name für die Warteschlange, die im Netzwerk eindeutig ist.

Attribute
MessagingDescriptionAttribute

Ausnahmen

MessageQueueException

Der Path Wert ist nicht festgelegt.

- oder -

Fehler beim Zugriff auf eine Message Queuing-Methode.

Beispiele

Im folgenden Codebeispiel wird der Wert der Eigenschaft einer Nachrichtenwarteschlange FormatName angezeigt.

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

Hinweise

Die FormatName Eigenschaft enthält den Formatnamen der Warteschlange. Message Queuing verwendet den Formatnamen, um zu identifizieren, welche Warteschlange geöffnet werden soll und wie auf sie zugegriffen werden soll. Im Gegensatz zu den meisten Merkmalen einer Warteschlange ist der Formatname keine Message Queuing-Anwendungswarteschlangeneigenschaft, sodass Sie nicht über das Verwaltungstool "Message Queuing" darauf zugreifen können. Der Formatname ist einfach ein eindeutiger Name für die Warteschlange, den Message Queuing generiert, wenn sie die Warteschlange erstellt oder die Anwendung später generiert.

Wenn Sie einen Pfad mithilfe der Pfadnamensyntax (z myComputer\myQueue. B. ) angeben, anstatt die Formatnamensyntax beim Lesen oder Schreiben in die Warteschlange zu verwenden, übersetzt der primäre Domänencontroller (der Active Directory verwendet) die Path Datei in die zugeordnete FormatName Datei, bevor Sie auf die Warteschlange zugreifen. Wenn Ihre Anwendung offline arbeitet, müssen Sie die Formatnamensyntax verwenden. andernfalls steht der primäre Domänencontroller nicht zur Verfügung, um die Pfadübersetzung durchzuführen.

In der folgenden Tabelle wird gezeigt, ob diese Eigenschaft in verschiedenen Arbeitsgruppenmodi verfügbar ist.

Arbeitsgruppenmodus Verfügbar
Lokaler Computer Ja
Name des lokalen Computers und des direkten Formats Ja
Remotecomputer Ja
Name des Remotecomputers und des direkten Formats Ja

Gilt für:

Weitere Informationen