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

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

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

Message.Authenticated プロパティ

メッセージが認証されたかどうかを示す値を取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 Authenticated As Boolean

Visual Basic (使用法)

Dim instance As Message
Dim value As Boolean

value = instance.Authenticated

public bool Authenticated { get;
 }

C++

public:
property bool Authenticated {
    bool get ();
}

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

JScript

public function get Authenticated
 () : boolean

プロパティ値
メッセージがキューに格納されたときにメッセージの認証が要求された場合は true。それ以外の場合は false。

例外

例外の種類	条件
InvalidOperationException	メッセージは送信されていません。このプロパティは、キューから取得したメッセージでだけ読み込むことができます。またはフィルタ処理されたメッセージキューが、Authenticated プロパティを無視します。

例外の種類

条件

InvalidOperationException

メッセージは送信されていません。このプロパティは、キューから取得したメッセージでだけ読み込むことができます。

または

フィルタ処理されたメッセージキューが、Authenticated プロパティを無視します。

解説

アプリケーションだけに使用される Authenticated プロパティは、メッセージとの対話中に認証が要求されているかどうかを調べます。メッセージがキューの中にあれば、そのメッセージは認証されています。逆に、Authenticated プロパティが true の場合、受信側キューマネージャはメッセージの受信時にそのメッセージを認証しています。

メッセージの認証に失敗したかどうかをメッセージのプロパティを参照することで判断することはできません。メッセージキューは、キューに配信される前に認証に失敗したメッセージを破棄します。しかし、配信の失敗によってメッセージがキューに到達できなかった場合に受信確認メッセージを送信するように要求できます。

使用例

メッセージの Authenticated プロパティの値を表示するコード例を次に示します。

// Display the value of the message's Authenticated property.
// To view this property value, the queue's
// MessageReadPropertyFilter.Authenticated property must be set to
// true before the message is received.
Console.WriteLine("Authentication requested for this
 message: {0}",
    orderMessage.Authenticated.ToString());

C++

// Display the value of the message's Authenticated property.
// To view this property value, the queue's
// MessageReadPropertyFilter.Authenticated property must be set to
// true before the message is received.
Console::WriteLine("Authentication requested for this
 message: {0}",
    orderMessage->Authenticated.ToString());

// Display the value of the message's Authenticated property.
// To view this property value, the queue's
// MessageReadPropertyFilter.Authenticated property must be set to
// true before the message is received.
Console.WriteLine("Authentication requested for this
 message: {0}", 
    System.Convert.ToString(orderMessage.get_Authenticated()));