MessageQueue.Label-Eigenschaft

Artikel
08/20/2007

Ruft die Beschreibung der Warteschlange ab oder legt diese fest.

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

Syntax

'Declaration
Public Property Label As String
'Usage
Dim instance As MessageQueue
Dim value As String

value = instance.Label

instance.Label = value

public string Label { get; set; }

public:
property String^ Label {
    String^ get ();
    void set (String^ value);
}

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

/** @property */
public void set_Label (String value)

public function get Label () : String

public function set Label (value : String)

Eigenschaftenwert

Die Bezeichnung der Meldungswarteschlange. Der Standardwert ist eine leere Zeichenfolge ("").

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentException	Die Bezeichnung wurde auf einen ungültigen Wert festgelegt.
MessageQueueException	Fehler beim Zugriff auf eine Message Queuing-Methode.

Hinweise

Die maximale Länge für die Bezeichnung einer Meldungswarteschlange beträgt 124 Zeichen.

Die Label-Eigenschaft muss nicht für jede Warteschlange eindeutig sein. Sollte für mehrere Warteschlangen das gleiche Label angegeben sein, können Sie mit der Send(Object)-Methode keine Meldungen an alle diese Warteschlangen übertragen. Wenn Sie beim Senden der Meldung für die Path-Eigenschaft die Bezeichnungssyntax verwenden, wird bei einem nicht eindeutigen Label eine Ausnahme ausgelöst.

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	Nein
Lokaler Computer + direkter Formatname	Nein

Beispiel

Im folgenden Codebeispiel wird der Wert der Label-Eigenschaft einer Meldungswarteschlange abgerufen und festgelegt.

// Set the queue's Label property value.
queue.Label = "Example Queue";

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

// Set the queue's Label property value.
queue.set_Label("Example Queue");
// Display the new value of the queue's Label property.
Console.WriteLine("MessageQueue.Label: {0}", queue.get_Label());

.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
MessageQueue.FormatName-Eigenschaft
GetPublicQueues
GetMessageQueueEnumerator

Freigeben über