MessageQueue.Category Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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, setPublic Property Category As GuidValeur de propriété
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
Exceptions
La catégorie de file d'attente définie 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 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 |
