MessageQueue.EncryptionRequired プロパティ

.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

C#

public EncryptionRequired EncryptionRequired { get;
 set; }

C++

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

J#

/** @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 プロパティに対し、値の取得と設定を行うコード例を次に示します。

C#

// 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);

J#

// 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());

.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

参照

関連項目
MessageQueue クラス
MessageQueue メンバ
System.Messaging 名前空間
Acknowledgment 列挙体
Message.UseEncryption プロパティ