MessageQueue.Label Egenskap

Definition

Namnområde:
System.Messaging
Sammansättning:
System.Messaging.dll

Hämtar eller anger köbeskrivningen.

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

Egenskapsvärde

String

Etiketten för meddelandekön. Standardvärdet är en tom sträng ("").

Attribut
MessagingDescriptionAttribute

Undantag

ArgumentException

Etiketten har angetts till ett ogiltigt värde.

MessageQueueException

Ett fel uppstod vid åtkomst till en Message Queuing-metod.

Exempel

Följande kodexempel hämtar och anger värdet för en meddelandekös Label egenskap.

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

Kommentarer

Den maximala längden på en meddelandeköetikett är 124 tecken.

Egenskapen Label behöver inte vara unik i alla köer. Men om flera köer delar samma Labelkan du inte använda Send(Object) metoden för att sända ett meddelande till dem alla. Om du använder etikettsyntaxen Path för egenskapen när du skickar meddelandet utlöses ett undantag om det Label inte är unikt.

I följande tabell visas om den här egenskapen är tillgänglig i olika arbetsgruppslägen.

Arbetsgruppsläge Tillgängligt
Lokal dator Yes
Namn på lokal dator och direktformat Yes
Fjärrdator No
Namn på fjärrdator och direktformat No

Gäller för

Se även