MessageQueue.Category プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
キュー カテゴリを取得または設定します。
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 (メッセージ キュー タイプ ID)。これによって、アプリケーションはキューを分類できます。 既定値は、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);
注釈
キュー カテゴリを使用すると、アプリケーションはそのキューを分類できます。 たとえば、すべての課金キューを 1 つのカテゴリに配置し、すべての注文キューを別のカテゴリに配置できます。
このプロパティは Category 、コンピューター管理コンソールの [ キューのプロパティ ] ダイアログ ボックスからアクセスできるメッセージ キューの種類 ID プロパティ (読み取り/書き込み) へのアクセスを提供します。 新しいカテゴリを定義できます。 すべてのGuid値で一意のカテゴリ値を作成するために使用NewGuidできますが、このようなアクションは不要です。 カテゴリ値は、他 Guid のすべての値からではなく、他のカテゴリとのみ区別する必要があります。 たとえば、キューの 1 つのセットに割り当てたり、{00000000-0000-0000-0000-000000000002}別のセットにCategory割り当てた{00000000-0000-0000-0000-000000000001}Categoryりすることができます。
を設定 Categoryする必要はありません。 値として null
を指定できます。
このプロパティを設定すると、メッセージ キュー キューが変更されます。 そのため、その他 MessageQueue のインスタンスは変更の影響を受けます。
次の表は、このプロパティがさまざまなワークグループ モードで使用できるかどうかを示しています。
ワークグループ モード | 利用可能 |
---|---|
ローカル コンピューター | はい |
ローカル コンピューターと直接形式名 | はい |
リモート コンピューター | いいえ |
リモート コンピューターと直接形式名 | いいえ |