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óry 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. Można na przykład 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 (odczytu/zapisu), dostępnej 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 polecenia , aby utworzyć wartość kategorii, która jest unikatowa dla wszystkich Guid wartości, 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 element Category dla jednego zestawu kolejek i {00000000-0000-0000-0000-000000000002} jako Category dla innego zestawu.

Nie jest konieczne ustawienie .Category Wartość może mieć wartość null.

Ustawienie tej właściwości powoduje zmodyfikowanie kolejki kolejkowania komunikatów. W związku z tym zmiana ma wpływ na inne MessageQueue wystąpienia.

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
Nazwa komputera lokalnego i bezpośredniego formatu Tak
Komputer zdalny Nie
Nazwa komputera zdalnego i bezpośredniego formatu Nie

Dotyczy

Zobacz też