RSA.ToXmlString(Boolean) Méthode

  • Référence

Définition

Espace de noms:
System.Security.Cryptography
Assembly:
System.Security.Cryptography.Algorithms.dll
Assembly:
System.Security.Cryptography.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Crée et retourne une chaîne XML contenant la clé de l'objet RSA actif.

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

Paramètres

includePrivateParameters
Boolean

true pour inclure une clé RSA publique et privée; false pour inclure uniquement la clé publique.

Retours

String

Chaîne XML contenant la clé de l'objet RSA actif.

Exceptions

PlatformNotSupportedException

.NET Core et .NET 5 (et versions ultérieures) uniquement : Dans tous les cas.

Remarques

La ToXmlString méthode crée une chaîne XML qui contient la clé publique et privée de l’objet actuel RSA ou ne contient que la clé publique de l’objet actif RSA .

Utilisez la ToXmlString méthode chaque fois que vous avez besoin de conserver facilement les informations de clé RSA. Pour initialiser un RSA objet avec la clé dans une chaîne XML, utilisez la FromXmlString méthode.

Attention

La persistance d’une chaîne XML contenant une clé privée à un emplacement non sécurisé est une menace de sécurité. La sécurité de votre application peut être compromise si un tiers malveillant peut accéder à votre clé privée. Pour conserver en toute sécurité une clé privée, utilisez un conteneur de clés sécurisées. Pour plus d’informations sur la persistance des clés privées dans un conteneur de clés, consultez Guide pratique pour stocker des clés asymétriques dans un conteneur de clés.

Lorsque vous passez true à la ToXmlString méthode, la chaîne XML résultante prend la forme suivante :

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

Lorsque vous passez false à la ToXmlString méthode, la chaîne XML résultante prend la forme suivante :

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

S’applique à

Voir aussi