MessageQueue.Category Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Messaging
Zestaw:
System.Messaging.dll

Pobiera lub ustawia kategorię kolejki.

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

Wartość właściwości

Guid

Element Guid reprezentujący kategorię kolejki (identyfikator typu kolejkowania komunikatów), która umożliwia aplikacji kategoryzowanie kolejek. Wartość domyślna to Guid.empty.

Atrybuty
MessagingDescriptionAttribute

Wyjątki

ArgumentException

Kategoria kolejki została ustawiona na nieprawidłową wartość.

MessageQueueException

Wystąpił błąd podczas uzyskiwania dostępu do metody kolejkowania komunikatów.

Przykłady

Poniższy przykład kodu pobiera i ustawia wartość właściwości kolejki komunikatów Category .

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

Uwagi

Kategoria kolejki umożliwia aplikacji kategoryzowanie kolejek. Na przykład można umieścić wszystkie kolejki rozliczeniowe w jednej kategorii i wszystkie kolejki zamówień w innej.

Właściwość Category zapewnia dostęp do właściwości Identyfikator typu kolejkowania komunikatów (która jest odczytywana/zapisywana), dostępna za pośrednictwem okna dialogowego Właściwości kolejki w konsoli zarządzania komputerem. Możesz zdefiniować nową kategorię. Chociaż można użyć NewGuid do utworzenia wartości kategorii, która jest unikatowa we wszystkich Guid wartościach, taka akcja jest niepotrzebna. Wartość kategorii musi być różna tylko od innych kategorii, a nie ze wszystkich innych Guid wartości. Można na przykład przypisać {00000000-0000-0000-0000-000000000001} jako Category jeden zestaw kolejek i {00000000-0000-0000-0000-000000000002} jako Category zestaw dla innego zestawu.

Nie trzeba ustawiać parametru Category. Wartość może być null.

Ustawienie tej właściwości modyfikuje kolejkę kolejkowania komunikatów. W związku z tym wszelkie inne MessageQueue wystąpienia mają wpływ na zmianę.

W poniższej tabeli przedstawiono, czy ta właściwość jest dostępna w różnych trybach grupy roboczej.

Tryb grupy roboczej Dostępne
Komputer lokalny Tak
Komputer lokalny i nazwa formatu bezpośredniego Tak
Komputer zdalny Nie
Nazwa komputera zdalnego i formatu bezpośredniego Nie

Dotyczy

Zobacz też