MessageQueue.Category Свойство

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

Значение свойства

Объект Guid, представляющий категорию очереди (идентификатор типа очереди сообщений), которая позволяет приложению классифицировать его очереди. Значение по умолчанию — Guid.empty.

Атрибуты

MessagingDescriptionAttribute

Исключения

Примеры

В следующем примере кода возвращается и задается значение свойства очереди 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);

Комментарии

Категория очереди позволяет приложению классифицировать свои очереди. Например, можно поместить все очереди выставления счетов в одну категорию, а все очереди заказов — в другую.

Свойство Category предоставляет доступ к свойству Message Queuing Type ID (то есть для чтения и записи), доступ к которому можно получить через диалоговое окно Свойства очереди в консоли управления компьютером. Можно определить новую категорию. Хотя можно использовать для NewGuid создания уникального для всех Guid значений значения категории, такое действие не требуется. Значение категории должно отличаться только от других категорий, а не от всех остальных Guid значений. Например, можно назначить {00000000-0000-0000-0000-000000000001} как Category для одного набора очередей и {00000000-0000-0000-0000-000000000002} как для другого Category набора.

Нет необходимости задавать Category. Допускается значение null.

Задание этого свойства изменяет очередь очереди сообщений. Таким образом, изменение влияет на любые другие MessageQueue экземпляры.

В следующей таблице показано, доступно ли это свойство в различных режимах рабочей группы.

Применяется к

См. также раздел

• Id
• Label
• GetPublicQueues()