Udostępnij za pośrednictwem


MessageQueue.Label Właściwość

Definicja

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

Etykieta kolejki komunikatów. Wartością domyślną jest ciąg pusty ("").

Atrybuty

Wyjątki

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

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ż