MessageQueue.FormatName Eigenschaft

Referenz

Definition

Namespace:: System.Messaging

Assembly:: System.Messaging.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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:

Teilen über