MessageQueue.FormatName Eigenschaft

  • Referenz

Definition

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

Ruft den eindeutigen Namen der Warteschlange ab, den Message Queuing beim Erstellen der Warteschlange erzeugt 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 im Netzwerk eindeutige Name der Warteschlange.

Attribute
MessagingDescriptionAttribute

Ausnahmen

MessageQueueException

Path 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 darauf zugegriffen werden soll. Im Gegensatz zu den meisten Merkmalen einer Warteschlange ist der Formatname keine Message Queuing-Anwendungswarteschlangeneigenschaft, sodass Sie nicht über das Message Queuing-Verwaltungstool darauf zugreifen können. Der Formatname ist einfach ein eindeutiger Name für die Warteschlange, den Message Queuing generiert, wenn die Warteschlange erstellt wird oder den 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) vor dem Zugriff auf die Warteschlange in das Path zugeordnete FormatName . Wenn Ihre Anwendung offline funktioniert, müssen Sie die Formatnamensyntax verwenden. Andernfalls steht der primäre Domänencontroller nicht für die Pfadübersetzung zur Verfügung.

Die folgende Tabelle zeigt, ob diese Eigenschaft in verschiedenen Arbeitsgruppenmodi verfügbar ist.

Arbeitsgruppenmodus Verfügbar
Lokalem 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