Udostępnij za pośrednictwem

MessageQueue.Label Właściwość

Definicja

Przestrzeń nazw:
System.Messaging
Zestaw:
System.Messaging.dll

Pobiera lub ustawia opis kolejki.

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

Wartość właściwości

String

Etykieta kolejki komunikatów. Wartość domyślna to pusty ciąg ("").

Atrybuty
MessagingDescriptionAttribute

Wyjątki

ArgumentException

Etykieta została ustawiona na nieprawidłową wartość.

MessageQueueException

Wystąpił błąd podczas uzyskiwania dostępu do metody kolejkowania komunikatów.

Przykłady

Poniższy przykład kodu pobiera i ustawia wartość właściwości kolejki komunikatów Label .

// 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);

Uwagi

Maksymalna długość etykiety kolejki komunikatów wynosi 124 znaków.

Właściwość Label nie musi być unikatowa we wszystkich kolejkach. Jeśli jednak wiele kolejek współużytkuje to samo Label, nie można użyć Send(Object) metody w celu emisji komunikatu do wszystkich z nich. Jeśli używasz składni etykiety dla Path właściwości podczas wysyłania komunikatu, wyjątek zostanie zgłoszony, jeśli Label element nie jest unikatowy.

W poniższej tabeli przedstawiono, czy ta właściwość jest dostępna w różnych trybach grupy roboczej.

Tryb grupy roboczej Dostępny
Komputer lokalny Yes
Nazwa komputera lokalnego i bezpośredniego formatu Yes
Komputer zdalny Nie.
Nazwa komputera zdalnego i bezpośredniego formatu Nie.

Dotyczy

Zobacz też