RSA.ToXmlString(Boolean) Método

Definição

Namespace:

System.Security.Cryptography

Assembly:

System.Security.Cryptography.Algorithms.dll

Assembly:

System.Security.Cryptography.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Cria e retorna uma cadeia de caracteres XML que contém a chave do atual objeto RSA.

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

Parâmetros

includePrivateParameters

Boolean

true para incluir uma chave RSA pública e privada; false para incluir somente a chave pública.

Retornos

String

Uma cadeia de caracteres XML que contém a chave do atual objeto RSA.

Exceções

PlatformNotSupportedException

Somente .NET Core e .NET 5+: Em todos os casos.

Comentários

O ToXmlString método cria uma cadeia de caracteres XML que contém a chave pública e privada do objeto atual RSA ou contém apenas a chave pública do objeto atual RSA .

Use o ToXmlString método sempre que precisar persistir convenientemente as informações de chave RSA. Para inicializar um RSA objeto com a chave em uma cadeia de caracteres XML, use o FromXmlString método.

Cuidado

Persistir uma cadeia de caracteres XML que contém uma chave privada para um local inseguro é uma ameaça à segurança. A segurança do aplicativo pode ser comprometida se um terceiro mal-intencionado puder acessar sua chave privada. Para persistir com segurança uma chave privada, use um contêiner de chave segura. Para obter mais informações sobre a persistência de chaves privadas em um contêiner de chaves, consulte Como armazenar chaves assimétricas em um contêiner de chaves.

Quando você passa true para o ToXmlString método, a cadeia de caracteres XML resultante assume o seguinte formulário:

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

Quando você passa false para o ToXmlString método, a cadeia de caracteres XML resultante assume o seguinte formulário:

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

Confira também

• Serviços criptográficos