次の方法で共有


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 (メッセージ キュー タイプ 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 プロパティ (読み取り/書き込み) へのアクセスを提供します。 新しいカテゴリを定義できます。 を使用 NewGuid して、すべての Guid 値で一意のカテゴリ値を作成できますが、このようなアクションは不要です。 カテゴリ値は、他のすべての値とは異なり、他 Guid のカテゴリとは異なる必要があります。 たとえば、1 つのキュー {00000000-0000-0000-0000-000000000002} セットの として をCategory、別のセットの として をCategory割り当てることができます{00000000-0000-0000-0000-000000000001}。

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

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

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

ワークグループ モード 利用可能
ローカル コンピューター はい
ローカル コンピューターと直接形式の名前 はい
リモート コンピューター いいえ
リモート コンピューターと直接形式の名前 いいえ

適用対象

こちらもご覧ください