Sdílet prostřednictvím

MessageQueue.Label Vlastnost

  • Reference

Definice

Obor názvů:
System.Messaging
Sestavení:
System.Messaging.dll

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

String

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

Atributy
MessagingDescriptionAttribute

Výjimky

ArgumentException

Popisek byl nastaven na neplatnou hodnotu.

MessageQueueException

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é