MessageQueue.Category 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 haalt u de wachtrijcategorie op of stelt u deze in.
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 GuidWaarde van eigenschap
Een Guid die de wachtrijcategorie (Message Queuing-type-id) vertegenwoordigt, waarmee een toepassing de wachtrijen kan categoriseren. De standaardwaarde is Guid.empty.
- Kenmerken
Uitzonderingen
De wachtrijcategorie 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 Category opgehaald en ingesteld.
// 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);
Opmerkingen
Met de wachtrijcategorie kan een toepassing de wachtrijen categoriseren. U kunt bijvoorbeeld alle factureringswachtrijen in één categorie en alle orderwachtrijen in een andere categorie plaatsen.
De Category eigenschap biedt toegang tot de eigenschap Message Queuing Type ID (die lezen/schrijven is), die toegankelijk is via het dialoogvenster Wachtrijeigenschappen in de computerbeheerconsole. U kunt een nieuwe categorie definiëren. Hoewel u een categoriewaarde kunt NewGuid maken die uniek is voor alle Guid waarden, is een dergelijke actie niet nodig. De categoriewaarde moet alleen verschillen van andere categorieën, niet van alle andere Guid waarden. U kunt bijvoorbeeld toewijzen {00000000-0000-0000-0000-000000000001} als de Category voor één set wachtrijen en {00000000-0000-0000-0000-000000000002} als de Category voor een andere set.
Het is niet nodig om de Category. De waarde kan zijn null.
Als u deze eigenschap instelt, wordt de Message Queuing-wachtrij gewijzigd. Daarom worden alle andere MessageQueue exemplaren beïnvloed door de wijziging.
In de volgende tabel ziet u of deze eigenschap beschikbaar is in verschillende werkgroepmodi.
| Werkgroepmodus | Beschikbaar |
|---|---|
| Lokale computer | Yes |
| Naam van lokale computer en directe indeling | Yes |
| Externe computer | No |
| Naam van externe computer en directe indeling | No |
