Partager via


MessageQueue.Label Propriété

Définition

Obtient ou définit la description de la file d'attente.

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

Valeur de propriété

Étiquette de la file d'attente de messages. La valeur par défaut est une chaîne vide ("").

Attributs

Exceptions

La valeur de l'étiquette est non valide.

Une erreur s'est produite lors de l'accès à une méthode Message Queuing.

Exemples

L’exemple de code suivant obtient et définit la valeur de la propriété d’une file d’attente de Label messages.

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

Remarques

La longueur maximale d’une étiquette de file d’attente de messages est de 124 caractères.

La Label propriété n’a pas besoin d’être unique dans toutes les files d’attente. Toutefois, si plusieurs files d’attente partagent le même Label, vous ne pouvez pas utiliser la Send(Object) méthode pour diffuser un message à toutes. Si vous utilisez la syntaxe d’étiquette pour la Path propriété lorsque vous envoyez le message, une exception est levée si n’est Label pas unique.

Le tableau suivant indique si cette propriété est disponible dans différents modes de groupe de travail.

Mode groupe de travail Disponible
Ordinateur local Oui
Ordinateur local et nom de format direct Oui
Ordinateur distant Non
Ordinateur distant et nom de format direct Non

S’applique à

Voir aussi