Sdílet prostřednictvím

MessageQueue.Category Vlastnost

Definice

Obor názvů:
System.Messaging
Sestavení:
System.Messaging.dll

Získá nebo nastaví kategorii fronty.

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

Hodnota vlastnosti

Guid

A Guid , který představuje kategorii fronty (identifikátor typu Řízení front zpráv), která aplikaci umožňuje kategorizovat své fronty. Výchozí hodnota je Guid.empty.

Atributy
MessagingDescriptionAttribute

Výjimky

ArgumentException

Kategorie fronty byla nastavena na neplatnou hodnotu.

MessageQueueException

Při přístupu k metodě řízení front zpráv došlo k chybě.

Příklady

Následující příklad kódu získá a nastaví hodnotu vlastnosti fronty Category zpráv.

// 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);

Poznámky

Kategorie fronty umožňuje aplikaci kategorizovat její fronty. Můžete například umístit všechny fakturační fronty do jedné kategorie a všechny fronty objednávek v jiné.

Tato Category vlastnost poskytuje přístup k vlastnosti ID typu řízení front zpráv (což je čtení/zápis), přístupné prostřednictvím dialogového okna Vlastnosti fronty v konzole pro správu počítače. Můžete definovat novou kategorii. I když můžete použít NewGuid k vytvoření hodnoty kategorie, která je jedinečná napříč všemi Guid hodnotami, taková akce není nutná. Hodnota kategorie musí být odlišná pouze od ostatních kategorií, nikoli od všech ostatních Guid hodnot. Můžete například přiřadit {00000000-0000-0000-0000-000000000001} jednu Category sadu front a {00000000-0000-0000-0000-000000000002} jako Category druhou sadu.

Není nutné nastavit Category. Hodnota může být null.

Nastavení této vlastnosti upraví frontu služby Řízení front zpráv. Proto jsou změny ovlivněny všemi dalšími MessageQueue instancemi.

Následující tabulka ukazuje, zda je tato vlastnost k dispozici v různých režimech pracovní skupiny.

Režim pracovní skupiny K dispozici
Místní počítač Ano
Název místního počítače a přímého formátu Ano
Vzdálený počítač Ne
Název vzdáleného počítače a přímého formátu Ne

Platí pro

Viz také