RSA.ToXmlString(Boolean) Método

Definição

Namespace:

System.Security.Cryptography

Assembly:

System.Security.Cryptography.dll

Origem:

RSA.Xml.cs

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 poderá 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 como manter 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