MessageQueue.Category プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

MessageQueue.Category プロパティ

キューカテゴリを取得または設定します。

名前空間: System.Messaging
アセンブリ: System.Messaging (system.messaging.dll 内)
構文

Visual Basic (宣言)

Public Property Category As
 Guid

Visual Basic (使用法)

Dim instance As MessageQueue
Dim value As Guid

value = instance.Category

instance.Category = value

public Guid Category { get; set;
 }

C++

public:
property Guid Category {
    Guid get ();
    void set (Guid value);
}

/** @property */
public Guid get_Category ()

/** @property */
public void set_Category (Guid value)

JScript

public function get Category
 () : Guid

public function set Category
 (value : Guid)

プロパティ値
キューカテゴリを表す Guid (メッセージキュータイプ ID)。これによって、アプリケーションはキューを分類できます。既定値は Guid.empty です。

例外

例外の種類	条件
ArgumentException	キューカテゴリに無効な値が設定されています。
MessageQueueException	メッセージキューのメソッドにアクセスしたときにエラーが発生しました。

解説

キューカテゴリによって、アプリケーションはキューを分類できます。たとえば、すべての請求キューを 1 つのカテゴリに分類し、すべての受注キューを別のカテゴリに分類できます。

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

必ずしも Category を設定する必要はありません。値は null 参照 (Visual Basic では Nothing) に設定できます。

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

このプロパティが各種のワークグループモードで使用できるかどうかを次の表に示します。

ワークグループモード	使用可否
ローカルコンピュータ	○
ローカルコンピュータと直接書式名	○
リモートコンピュータ	×
リモートコンピュータと直接書式名	×

使用例

メッセージキューの 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);

// Set the queue's Category property value.
queue.set_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.get_Category());