MessageQueue.Category 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取或设置队列类别。
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
。
- 属性
例外
队列类别被设置为无效值。
访问“消息队列”方法时出错。
示例
下面的代码示例获取并设置消息队列的 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 提供对消息队列类型 ID 属性 (,该属性) 可读/写,可通过计算机管理控制台中的“ 队列属性 ”对话框访问。 可以定义新类别。 尽管可以使用 NewGuid 创建在所有 Guid 值中唯一的类别值,但此类操作是不必要的。 类别值需要仅与其他类别不同,而不需要不同于所有其他 Guid 值。 例如,可以将 分配 {00000000-0000-0000-0000-000000000001} 为 Category 一组队列的 , {00000000-0000-0000-0000-000000000002} 将 分配为 Category 另一组队列的 。
无需设置 Category。 该值可以为 null
。
设置此属性会修改消息队列队列。 因此,任何其他 MessageQueue 实例都会受到更改的影响。
下表显示了此属性在各种工作组模式下是否可用。
工作组模式 | 可用 |
---|---|
本地计算机 | 是 |
本地计算机和直接格式名称 | 是 |
远程计算机 | 否 |
远程计算机和直接格式名称 | 否 |