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

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

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

MessagePropertyFilter.Authenticated プロパティ

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

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

Visual Basic (宣言)

Public Property Authenticated As
 Boolean

Visual Basic (使用法)

Dim instance As MessagePropertyFilter
Dim value As Boolean

value = instance.Authenticated

instance.Authenticated = value

public bool Authenticated { get;
 set; }

C++

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

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

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

JScript

public function get Authenticated
 () : boolean

public function set Authenticated
 (value : boolean)

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

解説

Message クラスの Authenticated プロパティは、認証が要求されたかどうかを判断するのに受信側アプリケーションが使います。認証が要求されたときにメッセージがキューの中にある場合、メッセージは認証されます。

メッセージのプロパティを参照して、メッセージの認証が失敗したかどうかを判断することはできません。認証に失敗したメッセージは破棄されるため、キューには渡されません。

使用例

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

// Set the queue's MessageReadPropertyFilter property to enable the
// message's Authenticated property.
queue.MessageReadPropertyFilter.Authenticated = 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 Authenticated property.
Console.WriteLine("Message.Authenticated: {0}",
    orderMessage.Authenticated);

C++

// Set the queue's MessageReadPropertyFilter property 
// to enable the message's Authenticated property.
queue->MessageReadPropertyFilter->Authenticated = 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 
// Authenticated property.
Console::WriteLine("Message.Authenticated: {0}", 
    orderMessage->Authenticated);

// Set the queue's MessageReadPropertyFilter property to enable the
// message's Authenticated property.
queue.get_MessageReadPropertyFilter().set_Authenticated(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 Authenticated property.
Console.WriteLine("Message.Authenticated: {0}", 
    System.Convert.ToString(orderMessage.get_Authenticated()));