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 可讓您存取 [計算機管理控制台] 中 [佇列類型標識元] 屬性 (，這是可擦寫) ，可透過 [ 佇列屬性 ] 對話框存取。 您可以定義新的類別。 雖然您可以使用 NewGuid 來建立所有 Guid 值中唯一的類別值，但不需要這類動作。 類別值必須只與其他類別不同，而不是與其他所有 Guid 值相異。 例如，您可以將 指派為Category一組佇列的 ，並將 {00000000-0000-0000-0000-000000000002} 指派{00000000-0000-0000-0000-000000000001}為Category另一組佇列的 。

不需要設定 Category。 這個值可以是 null。

設定這個屬性會修改消息佇列佇列。 因此，任何其他 MessageQueue 實例都會受到變更的影響。

下表顯示此屬性是否可在各種工作組模式中使用。

工作組模式	可用
本機電腦	是
本機計算機和直接格式名稱	是
遠端電腦	否
遠端電腦和直接格式名稱	否

另請參閱

• Id
• Label
• GetPublicQueues()