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

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

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

MessageQueue.EncryptionRequired プロパティ

キューが非プライベート (暗号化されていない) メッセージだけを受け入れるかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

Public Property EncryptionRequired As
 EncryptionRequired

Visual Basic (使用法)

Dim instance As MessageQueue
Dim value As EncryptionRequired

value = instance.EncryptionRequired

instance.EncryptionRequired = value

public EncryptionRequired EncryptionRequired { get;
 set; }

C++

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

/** @property */
public EncryptionRequired get_EncryptionRequired ()

/** @property */
public void set_EncryptionRequired (EncryptionRequired
 value)

JScript

public function get EncryptionRequired
 () : EncryptionRequired

public function set EncryptionRequired
 (value : EncryptionRequired)

プロパティ値
EncryptionRequired 値の 1 つ。既定値は None です。

例外

例外の種類	条件
MessageQueueException	メッセージキューのメソッドにアクセスしたときにエラーが発生しました。

解説

キューにメッセージを送信するときに暗号化が必要であることを指定すると、メッセージの本文だけが暗号化されます。その他のメンバ (Label プロパティや SenderId プロパティなど) の暗号化はできません。

このプロパティを設定すると、メッセージキューのキューが変更されます。したがって、他の MessageQueue インスタンスが変更による影響を受けます。

メッセージを暗号化すると、そのメッセージはプライベートになります。EncryptionRequired プロパティを適切に設定することによって、キューの暗号化要件を None、Body、または Optional に指定できます。メッセージの UseEncryption 設定は、キューの暗号化要件に対応させる必要があります。メッセージが暗号化されず、キューが Body に指定されている場合、またはメッセージが暗号化されて、キューが None に指定されている場合、メッセージはキューで拒否されます。送信元アプリケーションがこのイベントで否定受信確認メッセージを要求している場合、メッセージキューは送信元アプリケーションにメッセージの拒否を示します。UseDeadLetterQueue プロパティが true の場合、暗号化できなかったメッセージは配信不能キューに送信されます。それ以外の場合、メッセージは失われます。

このプロパティが各種のワークグループモードで使用できるかどうかを次の表に示します。

ワークグループモード	使用可否
ローカルコンピュータ	○
ローカルコンピュータと直接書式名	○
リモートコンピュータ	×
リモートコンピュータと直接書式名	×

使用例

メッセージキューの EncryptionRequired プロパティに対し、値の取得と設定を行うコード例を次に示します。

// Set the queue's EncryptionRequired property value.
queue.EncryptionRequired = System.Messaging.EncryptionRequired.Optional;

// Display the new value of the queue's EncryptionRequired property.
Console.WriteLine("MessageQueue.EncryptionRequired: {0}",
    queue.EncryptionRequired);

// Set the queue's EncryptionRequired property value.
queue.set_EncryptionRequired(
    System.Messaging.EncryptionRequired.Optional);
// Display the new value of the queue's EncryptionRequired property.
Console.WriteLine("MessageQueue.EncryptionRequired: {0}", 
    queue.get_EncryptionRequired());