MessageQueue.Label Özellik

Tanım

Ad Alanı:

System.Messaging

Bütünleştirilmiş Kod:

System.Messaging.dll

Kuyruk açıklamasını alır veya ayarlar.

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

Özellik Değeri

String

İleti kuyruğunun etiketi. Varsayılan değer, boş dizedir ("").

Öznitelikler

MessagingDescriptionAttribute

Özel durumlar

ArgumentException

Etiket geçersiz bir değere ayarlanmış.

MessageQueueException

Message Queuing yöntemine erişilirken bir hata oluştu.

Örnekler

Aşağıdaki kod örneği, ileti kuyruğunun Label özelliğinin değerini alır ve ayarlar.

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

Açıklamalar

İleti kuyruğu etiketinin uzunluğu üst sınırı 124 karakterdir.

Özelliğin Label tüm kuyruklarda benzersiz olması gerekmez. Ancak, birden çok kuyruk aynı Labelöğesini paylaşıyorsa, yöntemi kullanarak tümüne bir ileti yayımlayamazsınız Send(Object) . İletiyi gönderirken özelliği için etiket söz dizimini Path kullanırsanız, benzersiz değilse Label bir özel durum oluşturulur.

Aşağıdaki tabloda bu özelliğin çeşitli Çalışma Grubu modlarında kullanılabilir olup olmadığı gösterilmektedir.

Çalışma grubu modu	Kullanılabilir
Yerel bilgisayar	Yes
Yerel bilgisayar ve doğrudan biçim adı	Yes
Uzak bilgisayar	No
Uzak bilgisayar ve doğrudan biçim adı	No

Ayrıca bkz.

• Path
• FormatName
• GetPublicQueues()
• GetMessageQueueEnumerator()