MessageQueue.Category Свойство

  • Ссылка

Определение

Пространство имен:
System.Messaging
Сборка:
System.Messaging.dll

Возвращает или задает категорию очереди.

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, представляющий категорию очереди (идентификатор типа очереди сообщений), которая позволяет приложению классифицировать его очереди. Значение по умолчанию — Guid.empty.

Атрибуты
MessagingDescriptionAttribute

Исключения

ArgumentException

Для категории очереди задано недопустимое значение.

MessageQueueException

При обращении к методу службы очереди сообщений возникла ошибка.

Примеры

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

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

Режим рабочей группы Доступно
Локальный компьютер Да
Имя локального компьютера и прямого формата Да
Удаленный компьютер Нет
Имя удаленного компьютера и прямого формата Нет

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

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