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 です。

属性

MessagingDescriptionAttribute

例外

例

次のコード例では、メッセージ キューの 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);

注釈

キュー カテゴリを使用すると、アプリケーションはキューを分類できます。 たとえば、すべての課金キューを 1 つのカテゴリに配置し、すべての注文キューを別のカテゴリに配置できます。

Category プロパティは、コンピューター管理コンソールの [キューのプロパティ] ダイアログ ボックスからアクセスできるメッセージ キューの種類 ID プロパティ (読み取り/書き込み) へのアクセスを提供します。 新しいカテゴリを定義できます。 NewGuidを使用して、すべてのGuid値で一意のカテゴリ値を作成できますが、このようなアクションは不要です。 カテゴリ値は、他のすべての Guid 値とは異なるのではなく、他のカテゴリとのみ区別する必要があります。 たとえば、キューのセットの{00000000-0000-0000-0000-000000000001}としてCategoryを割り当て、別のセットの{00000000-0000-0000-0000-000000000002}としてCategoryすることができます。

Categoryを設定する必要はありません。 値は nullできます。

このプロパティを設定すると、メッセージ キュー キューが変更されます。 そのため、その他の MessageQueue インスタンスは変更の影響を受けます。

次の表は、このプロパティがさまざまなワークグループ モードで使用できるかどうかを示しています。

こちらもご覧ください

• Id
• Label
• GetPublicQueues()