MessagePropertyFilter.DefaultExtensionSize プロパティ

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

MessagePropertyFilter.DefaultExtensionSize プロパティ

拡張バッファの既定サイズ (バイト数) を取得または設定します。

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

Visual Basic (宣言)

Public Property DefaultExtensionSize As
 Integer

Visual Basic (使用法)

Dim instance As MessagePropertyFilter
Dim value As Integer

value = instance.DefaultExtensionSize

instance.DefaultExtensionSize = value

C#

public int DefaultExtensionSize { get;
 set; }

C++

public:
property int DefaultExtensionSize {
    int get ();
    void set (int value);
}

J#

/** @property */
public int get_DefaultExtensionSize ()

/** @property */
public void set_DefaultExtensionSize (int
 value)

JScript

public function get DefaultExtensionSize
 () : int

public function set DefaultExtensionSize
 (value : int)

プロパティ値
メッセージの受信時に作成される拡張バッファの既定サイズ。既定値は 255 バイトです。

例外

例外の種類	条件
ArgumentException	代入値が負の値です。

解説

既定の拡張バッファのサイズによって、メッセージの拡張部のために割り当てるバイト数が決まります。Message クラスの Extension プロパティは、バイナリ ラージ オブジェクト (BLOB) など、メッセージに関連付けられるアプリケーション定義の追加情報を表します。Extension の内容の解釈は、アプリケーションで行う必要があります。

使用例

DefaultExtensionSize プロパティの使用方法を示すコード例を次に示します。

C#

// Set the filter's DefaultExtensionSize property to 1024 bytes.
queue.MessageReadPropertyFilter.DefaultExtensionSize = 1024;

// Display the new value of the filter's DefaultExtensionSize property.
Console.WriteLine("MessageReadPropertyFilter.DefaultExtensionSize: {0}"
,
    queue.MessageReadPropertyFilter.DefaultExtensionSize.ToString());

C++

// Set the filter's DefaultExtensionSize
// property to 1024 bytes.
queue->MessageReadPropertyFilter->
    DefaultExtensionSize = 1024;

// Display the new value of the filter's 
// DefaultExtensionSize property.
Console::WriteLine(
    "MessageReadPropertyFilter."
    "DefaultExtensionSize: {0}", 
    queue->MessageReadPropertyFilter->
    DefaultExtensionSize);

J#

// Set the filter's DefaultExtensionSize property to 1024 bytes.
queue.get_MessageReadPropertyFilter().set_DefaultExtensionSize(1024);
// Display the new value of the filter's DefaultExtensionSize property.
Console.WriteLine("MessageReadPropertyFilter.DefaultExtensionSize: {0}"
, 
    System.Convert.ToString(queue.get_MessageReadPropertyFilter().
    get_DefaultExtensionSize()));

.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

参照

関連項目
MessagePropertyFilter クラス
MessagePropertyFilter メンバ
System.Messaging 名前空間
Message クラス
Extension
MessageQueue