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

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

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

MessagePropertyFilter.Extension プロパティ

メッセージを受信またはピークするときに Message.Extension プロパティ情報を取得するかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

Public Property Extension As
 Boolean

Visual Basic (使用法)

Dim instance As MessagePropertyFilter
Dim value As Boolean

value = instance.Extension

instance.Extension = value

public bool Extension { get;
 set; }

C++

public:
property bool Extension {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_Extension ()

/** @property */
public void set_Extension (boolean value)

JScript

public function get Extension
 () : boolean

public function set Extension
 (value : boolean)

プロパティ値
Message.Extension 情報を受信する場合は true。それ以外の場合は false。既定値は false です。

解説

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

使用例

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

// Set the queue's MessageReadPropertyFilter property to enable the
// message's Extension property.
queue.MessageReadPropertyFilter.Extension = true;

// Peek at the message. Time out after ten seconds in case the message
// was not delivered.
orderMessage = queue.Peek(TimeSpan.FromSeconds(10.0)); 

// Display the value of the message's Extension property.
Console.WriteLine("Message.Extension: {0}",
    orderMessage.Extension);

C++

// Set the queue's MessageReadPropertyFilter property 
// to enable the message's Extension property.
queue->MessageReadPropertyFilter->Extension = true;

// Peek at the message. Time out after ten seconds 
// in case the message was not delivered.
orderMessage = queue->Peek(TimeSpan::FromSeconds(10.0));

// Display the value of the message's Extension property.
Console::WriteLine("Message.Extension: {0}", 
    orderMessage->Extension);

// Set the queue's MessageReadPropertyFilter property to enable the
// message's Extension property.
queue.get_MessageReadPropertyFilter().set_Extension(true);
// Peek at the message. Time out after ten seconds in case the message
// was not delivered.
orderMessage = queue.Peek(TimeSpan.FromSeconds(10.0));
// Display the value of the message's Extension property.
Console.WriteLine("Message.Extension: {0}", 
    System.Convert.ToString(orderMessage.get_Extension()));