MessageQueue.Label Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt de beschrijving van de wachtrij opgehaald of ingesteld.
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, setPublic Property Label As StringWaarde van eigenschap
Het label voor de berichtenwachtrij. De standaardwaarde is een lege tekenreeks ("").
- Kenmerken
Uitzonderingen
Het label is ingesteld op een ongeldige waarde.
Er is een fout opgetreden bij het openen van een Message Queuing-methode.
Voorbeelden
In het volgende codevoorbeeld wordt de waarde van de eigenschap van een berichtenwachtrij Label opgehaald en ingesteld.
// 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);
Opmerkingen
De maximale lengte van een berichtwachtrijlabel is 124 tekens.
De Label eigenschap hoeft niet uniek te zijn in alle wachtrijen. Als meerdere wachtrijen echter hetzelfde Labeldelen, kunt u de Send(Object) methode niet gebruiken om een bericht naar alle wachtrijen uit te zenden. Als u de labelsyntaxis voor de Path eigenschap gebruikt wanneer u het bericht verzendt, wordt er een uitzondering gegenereerd als deze Label niet uniek is.
In de volgende tabel ziet u of deze eigenschap beschikbaar is in verschillende werkgroepmodi.
| Werkgroepmodus | Available |
|---|---|
| Lokale computer | Ja |
| Naam van lokale computer en directe indeling | Ja |
| Externe computer | No |
| Naam van externe computer en directe indeling | No |