MessageQueue.FormatName-Eigenschaft

Ruft den eindeutigen Namen der Warteschlange ab, den Message Queuing beim Erstellen der Warteschlange erzeugt hat.

Namespace: System.Messaging
Assembly: System.Messaging (in system.messaging.dll)

Syntax

'Declaration
Public ReadOnly Property FormatName As String
'Usage
Dim instance As MessageQueue
Dim value As String

value = instance.FormatName

public string FormatName { get; }

public:
property String^ FormatName {
    String^ get ();
}

/** @property */
public String get_FormatName ()

public function get FormatName () : String

Eigenschaftenwert

Der im Netzwerk eindeutige Name der Warteschlange.

Ausnahmen

Ausnahmetyp	Bedingung
MessageQueueException	Die Path-Eigenschaft wurde nicht festgelegt. - oder - Fehler beim Zugriff auf eine Message Queuing-Methode.

Hinweise

Die FormatName-Eigenschaft enthält den Formatnamen der Warteschlange. Message Queuing stellt über den Formatnamen fest, welche Warteschlange geöffnet werden soll und wie auf diese zugegriffen wird. Im Gegensatz zu den meisten anderen Merkmalen einer Warteschlange ist der Formatname keine Warteschlangeneigenschaft von Message Queuing. Er kann daher nicht über das Message Queuing-Verwaltungstool abgerufen werden. Der Formatname ist einfach ein eindeutiger Name für die Warteschlange, der von Message Queuing beim Erstellen der Warteschlange oder zu einem späteren Zeitpunkt von der Anwendung erzeugt wird.

Wenn Sie beim Schreiben oder Lesen der Warteschlange einen Pfad unter Verwendung der Syntax für Pfadnamen (z. B. myComputer\myQueue) anstelle der Syntax für Formatnamen angeben, übersetzt der primäre Domänenkontroller (der Active Directory verwendet) vor dem Zugriff auf die Warteschlange den Path in den entsprechenden FormatName. Wenn die Anwendung offline ausgeführt wird, müssen Sie die Syntax für Formatnamen verwenden, da in diesem Falle der primäre Domänencontroller nicht für die Übersetzung des Pfades zur Verfügung steht.

Der folgenden Tabelle können Sie entnehmen, ob diese Eigenschaft in verschiedenen Arbeitsgruppenmodi verfügbar ist.

Arbeitsgruppenmodus	Verfügbar
Lokaler Computer	Ja
Lokaler Computer + direkter Formatname	Ja
Remotecomputer	Ja
Lokaler Computer + direkter Formatname	Ja

Beispiel

Im folgenden Codebeispiel wird der Wert der FormatName-Eigenschaft einer Meldungswarteschlange angezeigt.

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

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

.NET Framework-Sicherheit

• Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0

Siehe auch

Referenz

MessageQueue-Klasse
MessageQueue-Member
System.Messaging-Namespace
Path
Label
MessageQueue-Klasse