MessageQueue.Category Propriété

  • Référence

Définition

Espace de noms:
System.Messaging
Assembly:
System.Messaging.dll

Obtient ou définit la catégorie de la file d'attente.

public:
 property Guid Category { Guid get(); void set(Guid value); };
[System.Messaging.MessagingDescription("MQ_Category")]
public Guid Category { get; set; }
[<System.Messaging.MessagingDescription("MQ_Category")>]
member this.Category : Guid with get, set
Public Property Category As Guid

Valeur de propriété

Guid

Guid qui représente la catégorie de file d'attente (identificateur de type Message Queuing) qui permet à une application de classer par catégorie ses files d'attente. La valeur par défaut est Guid.empty.

Attributs
MessagingDescriptionAttribute

Exceptions

ArgumentException

La catégorie de file d'attente définie est non valide.

MessageQueueException

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 Category messages.

// Set the queue's Category property value.
queue.Category =
    new System.Guid("00000000-0000-0000-0000-000000000001");

// Display the new value of the queue's Category property.
Console.WriteLine("MessageQueue.Category: {0}", queue.Category);

Remarques

La catégorie de file d’attente permet à une application de classer ses files d’attente. Par exemple, vous pouvez placer toutes les files d’attente de facturation dans une catégorie et toutes les files d’attente Commande dans une autre.

La Category propriété permet d’accéder à la propriété ID de type Message Queuing (qui est en lecture/écriture), accessible via la boîte de dialogue Propriétés de la file d’attente dans la console de gestion de l’ordinateur. Vous pouvez définir une nouvelle catégorie. Bien que vous puissiez utiliser NewGuid pour créer une valeur de catégorie unique sur toutes les Guid valeurs, une telle action n’est pas nécessaire. La valeur de catégorie doit être distincte uniquement des autres catégories, et non de toutes les autres Guid valeurs. Par exemple, vous pouvez affecter {00000000-0000-0000-0000-000000000001} en tant que pour Category un ensemble de files d’attente et {00000000-0000-0000-0000-000000000002} en tant que Category pour un autre ensemble.

Il n’est pas nécessaire de définir le Category. La valeur peut être null.

La définition de cette propriété modifie la file d’attente Message Queuing. Par conséquent, toutes les autres MessageQueue instances sont affectées par la modification.

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