MessageQueue.FormatName Eigenschaft
Definition
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 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 : stringPublic ReadOnly Property FormatName As StringEigenschaftswert
Der Name für die Warteschlange, die im Netzwerk eindeutig ist.
- Attribute
Ausnahmen
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 |
