MessageQueue.Category Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar eller anger kökategorin.
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
Egenskapsvärde
En Guid som representerar kökategorin (identifierare för Message Queuing-typ), som gör att ett program kan kategorisera sina köer. Standardvärdet är Guid.empty.
- Attribut
Undantag
Kökategorin har angetts till ett ogiltigt värde.
Ett fel uppstod vid åtkomst till en Message Queuing-metod.
Exempel
Följande kodexempel hämtar och anger värdet för en meddelandekös Category egenskap.
// 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);
Kommentarer
Kökategorin gör att ett program kan kategorisera sina köer. Du kan till exempel placera alla faktureringsköer i en kategori och alla orderköer i en annan.
Egenskapen Category ger åtkomst till egenskapen Message Queuing Type ID (som är läs/skriv), som är tillgänglig via dialogrutan Köegenskaper i datorhanteringskonsolen. Du kan definiera en ny kategori. Även om du kan använda NewGuid för att skapa ett kategorivärde som är unikt för alla Guid värden, är en sådan åtgärd onödig. Kategorivärdet måste endast skilja sig från andra kategorier, inte från alla andra Guid värden. Du kan till exempel tilldela {00000000-0000-0000-0000-000000000001} som Category för en uppsättning köer och {00000000-0000-0000-0000-000000000002} som Category för en annan uppsättning.
Det är inte nödvändigt att ange Category. Värdet kan vara null.
Om du ställer in den här egenskapen ändras kön för meddelandeköer. Därför påverkas alla andra MessageQueue instanser av ändringen.
I följande tabell visas om den här egenskapen är tillgänglig i olika arbetsgruppslägen.
| Arbetsgruppsläge | Tillgängligt |
|---|---|
| Lokal dator | Yes |
| Namn på lokal dator och direktformat | Yes |
| Fjärrdator | No |
| Namn på fjärrdator och direktformat | No |