Message.Extension プロパティ

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

Message.Extension プロパティ

メッセージに関連付けられているアプリケーション定義の追加情報を取得または設定します。

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

Visual Basic (宣言)

Public Property Extension As
 Byte()

Visual Basic (使用法)

Dim instance As Message
Dim value As Byte()

value = instance.Extension

instance.Extension = value

C#

public byte[] Extension { get; set;
 }

C++

public:
property array<unsigned char>^ Extension {
    array<unsigned char>^ get ();
    void set (array<unsigned char>^
 value);
}

J#

/** @property */
public byte[] get_Extension ()

/** @property */
public void set_Extension (byte[] value)

JScript

public function get Extension
 () : byte[]

public function set Extension
 (value : byte[])

プロパティ値
メッセージに関連付けられているアプリケーション定義の情報を提供するバイト値配列。既定値は長さ 0 の配列です。

例外

例外の種類	条件
InvalidOperationException	フィルタ処理されたメッセージ キューが、Extension プロパティを無視します。
ArgumentException	Extension プロパティが null 参照 (Visual Basic では Nothing) です。

解説

Extension プロパティは、ラージ バイナリ オブジェクトなど、メッセージに関連付けられているアプリケーション定義の情報を提供します。Extension プロパティの内容の解釈は、受信側アプリケーションで行う必要があります。

メッセージ データは、できる限り Extension プロパティではなくメッセージの Body プロパティに含めてください。

外部キューを使う場合は、メッセージ キュー内に存在しないメッセージ プロパティを指定するのに Extension プロパティを使います。

Microsoft メッセージ キュー以外のキュー システムに外部キューが存在します。メッセージ キューは、コネクタ アプリケーションを通じて外部キューと通信します。

.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

参照

関連項目
Message クラス
Message メンバ
System.Messaging 名前空間
Message.AppSpecific プロパティ
Message.Body プロパティ