Sdílet prostřednictvím


MessageQueue.Label Vlastnost

Definice

Získá nebo nastaví popis fronty.

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

Hodnota vlastnosti

Popisek fronty zpráv. Výchozí hodnota je prázdný řetězec ("").

Atributy

Výjimky

Popisek byl nastaven na neplatnou hodnotu.

Při přístupu k metodě služby Řízení front zpráv došlo k chybě.

Příklady

Následující příklad kódu získá a nastaví hodnotu vlastnosti fronty Label zpráv.

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

Poznámky

Maximální délka popisku fronty zpráv je 124 znaků.

Vlastnost Label nemusí být jedinečná ve všech frontách. Pokud však více front sdílí stejné Label, nemůžete použít metodu Send(Object) k vysílání zprávy všem z nich. Pokud při odesílání zprávy použijete syntaxi popisku pro Path vlastnost, vyvolá se výjimka, pokud Label není jedinečná.

Následující tabulka ukazuje, zda je tato vlastnost k dispozici v různých režimech pracovní skupiny.

Režim pracovní skupiny K dispozici.
Místní počítač Yes
Název místního počítače a přímého formátu Yes
Vzdálený počítač No
Název vzdáleného počítače a přímého formátu No

Platí pro

Viz také