MessageQueue.Label Właściwość

  • Odwołanie

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ścią domyślną jest ciąg pusty ("").

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ółdzieli to samo Label, nie można użyć Send(Object) metody , aby rozgłaszać komunikat 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ępne
Komputer lokalny Tak
Komputer lokalny i nazwa formatu bezpośredniego Tak
Komputer zdalny Nie
Nazwa komputera zdalnego i formatu bezpośredniego Nie

Dotyczy

Zobacz też