Freigeben über

MessageQueue.Label Eigenschaft

  • Referenz

Definition

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

Ruft die Beschreibung der Warteschlange ab oder legt diese fest.

public:
 property System::String ^ Label { System::String ^ get(); void set(System::String ^ value); };
[System.Messaging.MessagingDescription("MQ_Label")]
public string Label { get; set; }
[<System.Messaging.MessagingDescription("MQ_Label")>]
member this.Label : string with get, set
Public Property Label As String

Eigenschaftswert

String

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

Attribute
MessagingDescriptionAttribute

Ausnahmen

ArgumentException

Die Bezeichnung wurde auf einen ungültigen Wert festgelegt.

MessageQueueException

Fehler beim Zugriff auf eine Message Queuing-Methode.

Beispiele

Im folgenden Codebeispiel wird der Wert der Eigenschaft einer Nachrichtenwarteschlange Label 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);

Hinweise

Die maximale Länge einer Nachrichtenwarteschlangenbezeichnung beträgt 124 Zeichen.

Die Label Eigenschaft muss nicht für alle Warteschlangen eindeutig sein. Wenn jedoch mehrere Warteschlangen dieselbe Labelhaben, können Sie die Send(Object) -Methode nicht verwenden, um eine Nachricht an alle zu senden. Wenn Sie beim Senden der Nachricht die Bezeichnungssyntax für die Path Eigenschaft verwenden, wird eine Ausnahme ausgelöst, wenn die Label nicht eindeutig ist.

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 Nein
Name des Remotecomputers und des direkten Formats Nein

Gilt für:

Weitere Informationen