MessageQueue.Category Vlastnost

  • Reference

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

Objekt Guid představující kategorii fronty (identifikátor typu Řízení front zpráv), který umožňuje aplikaci kategorizovat fronty. Výchozí formát je Guid.empty.

Atributy
MessagingDescriptionAttribute

Výjimky

ArgumentException

Kategorie fronty byla nastavena na neplatnou hodnotu.

MessageQueueException

Při přístupu k metodě služby Ří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 fronty. Můžete například umístit všechny fakturační fronty do jedné kategorie a všechny fronty objednávek do jiné.

Vlastnost Category poskytuje přístup k vlastnosti ID typu služby Řízení front zpráv (která je čtení/zápis), která je přístupná prostřednictvím dialogového okna Vlastnosti fronty v konzole Správa počítače. Můžete definovat novou kategorii. I když můžete vytvořit NewGuid hodnotu kategorie, která je jedinečná pro všechny Guid hodnoty, 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} jako Category pro jednu sadu front a {00000000-0000-0000-0000-000000000002} jako pro jinou Category sadu.

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

Nastavení této vlastnosti upraví frontu služby Řízení front zpráv. Proto jsou změnou ovlivněny všechny ostatní MessageQueue instance.

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č Yes
Název místního počítače a přímého formátu Yes
Vzdálený počítač No
Název vzdáleného počítače a přímého formátu No

Platí pro

Viz také