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 提供对消息队列类型 ID 属性 (，该属性) 可读/写，可通过计算机管理控制台中的“ 队列属性 ”对话框访问。 可以定义新类别。 尽管可以使用 NewGuid 创建在所有 Guid 值中唯一的类别值，但此类操作是不必要的。 类别值需要仅与其他类别不同，而不需要不同于所有其他 Guid 值。 例如，可以将 分配 {00000000-0000-0000-0000-000000000001} 为 Category 一组队列的 ， {00000000-0000-0000-0000-000000000002} 将 分配为 Category 另一组队列的 。

无需设置 Category。 该值可以为 null。

设置此属性会修改消息队列队列。 因此，任何其他 MessageQueue 实例都会受到更改的影响。

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

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

另请参阅

• Id
• Label
• GetPublicQueues()