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

属性

例外

队列类别被设置为无效值。

访问“消息队列”方法时出错。

示例

下面的代码示例获取并设置消息队列的 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 实例都会受到更改的影响。

下表显示了此属性在各种工作组模式下是否可用。

工作组模式 可用
本地计算机
本地计算机和直接格式名称
远程计算机
远程计算机和直接格式名称

适用于

另请参阅