MessageQueue.Category プロパティ

.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

C#

public Guid Category { get; set;
 }

C++

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

J#

/** @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 プロパティに対し、値の取得と設定を行うコード例を次に示します。

C#

// 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);

J#

// 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());

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
MessageQueue クラス
MessageQueue メンバ
System.Messaging 名前空間
Id
Label
GetPublicQueues