Freigeben über

MessageQueue.Label Eigenschaft

Definition

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

Ruft die Warteschlangenbeschreibung ab oder legt sie 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 für die Nachrichtenwarteschlange. 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 dasselbe Labelteilen, können Sie die Send(Object) Methode nicht verwenden, um eine Nachricht an alle zu übertragen. Wenn Sie beim Senden der Nachricht die Bezeichnungssyntax für die Path Eigenschaft verwenden, wird eine Ausnahme ausgelöst, wenn dies Label nicht eindeutig ist.

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

Gilt für:

Weitere Informationen