Message.UseEncryption プロパティ

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

Message.UseEncryption プロパティ

メッセージをプライベートにするかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

Public Property UseEncryption As
 Boolean

Visual Basic (使用法)

Dim instance As Message
Dim value As Boolean

value = instance.UseEncryption

instance.UseEncryption = value

C#

public bool UseEncryption { get;
 set; }

C++

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

J#

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

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

JScript

public function get UseEncryption
 () : boolean

public function set UseEncryption
 (value : boolean)

プロパティ値
メッセージ キューにメッセージを暗号化するように要求する場合は true。それ以外の場合は false。既定値は false です。

例外

例外の種類	条件
InvalidOperationException	フィルタ処理されたメッセージ キューが、UseEncryption プロパティを無視します。

解説

メッセージがプライベートの場合、メッセージの本文は送信される前に暗号化され、受信されるときに解読されます。プライベート メッセージを送信する場合、送信元アプリケーションは、使用する暗号方式と暗号化アルゴリズムを指定する必要があります (後者は省略可能)。

プライベート メッセージを送信するときに、アプリケーション側でメッセージの暗号化を実行する必要はありません。ディレクトリ サービスにアクセスできる Microsoft Windows 2000 エンタープライズ内でアプリケーションがメッセージを送信するときには、メッセージ キューにメッセージの本文を暗号化させることができます。プライベート メッセージを受信するときには、常に受信側キュー マネージャがメッセージの本文を解読します。

使用例

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

C#

// Set the message's UseEncryption property.
orderMessage.UseEncryption = true;

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

C++

// Set the message's UseEncryption property.
orderMessage->UseEncryption = true;

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

J#

// Set the message's UseEncryption property.
orderMessage.set_UseEncryption(true);
// Display the new value of the message's UseEncryption property.
Console.WriteLine("Message.UseEncryption: {0}", 
    System.Convert.ToString(orderMessage.get_UseEncryption()));

.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

参照

関連項目
Message クラス
Message メンバ
System.Messaging 名前空間
Message.EncryptionAlgorithm プロパティ
EncryptionRequired