RSA.ToXmlString(Boolean) メソッド

定義

現在の RSA オブジェクトのキーを格納している XML 文字列を作成して返します。Creates and returns an XML string containing the key of the current RSA object.

public:
 override System::String ^ ToXmlString(bool includePrivateParameters);
public override string ToXmlString (bool includePrivateParameters);
override this.ToXmlString : bool -> string
Public Overrides Function ToXmlString (includePrivateParameters As Boolean) As String

パラメーター

includePrivateParameters
Boolean

公開および秘密の RSA キーを含める場合は true。公開キーだけを含める場合は falsetrue to include a public and private RSA key; false to include only the public key.

戻り値

String

現在の RSA オブジェクトのキーを格納している XML 文字列。An XML string containing the key of the current RSA object.

例外

.NET Core のみ: このメンバーはサポートされていません。.NET Core only: This member is not supported.

注釈

ToXmlString メソッドは、現在の RSA オブジェクトの公開キーと秘密キーのどちらかを含む XML 文字列を作成します。または、現在の RSA オブジェクトの公開キーだけを格納します。The ToXmlString method creates an XML string that contains either the public and private key of the current RSA object or contains only the public key of the current RSA object.

RSA キーの情報を保存する必要がある場合は常に、ToXmlString メソッドを使用します。Use the ToXmlString method whenever you need to conveniently persist RSA key information. XML 文字列内のキーを使用して RSA オブジェクトを初期化するには、FromXmlString メソッドを使用します。To initialize an RSA object with the key in an XML string, use the FromXmlString method.

注意事項

秘密キーを含む XML 文字列を安全でない場所に永続化することは、セキュリティ上の脅威になります。Persisting an XML string containing a private key to an insecure location is a security threat. 悪意のあるサードパーティが秘密キーにアクセスできる場合、アプリケーションのセキュリティが侵害される可能性があります。The security of your application can be compromised if a malicious third party can access your private key. 秘密キーを安全に保持するには、セキュリティで保護されたキーコンテナーを使用します。To safely persist a private key, use a secure key container. キーコンテナーでの秘密キーの永続化の詳細については、「方法: キーコンテナーに非対称キーを格納する」を参照してください。For more information about persisting private keys in a key container, see How to: Store Asymmetric Keys in a Key Container.

trueToXmlString メソッドに渡すと、結果の XML 文字列の形式は次のようになります。When you pass true to the ToXmlString method, the resulting XML string takes the following form:

<RSAKeyValue>  
   <Modulus>…</Modulus>  
   <Exponent>…</Exponent>  
   <P>…</P>  
   <Q>…</Q>  
   <DP>…</DP>  
   <DQ>…</DQ>  
   <InverseQ>…</InverseQ>  
   <D>…</D>  
</RSAKeyValue>  

falseToXmlString メソッドに渡すと、結果の XML 文字列の形式は次のようになります。When you pass false to the ToXmlString method, the resulting XML string takes the following form:

<RSAKeyValue>  
   <Modulus>…</Modulus>  
   <Exponent>…</Exponent>  
</RSAKeyValue>  

適用対象

こちらもご覧ください