共用方式為


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

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

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

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

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

適用於

另請參閱