MessageQueue.Category Egenskap

Definition

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

Gäller för

Se även