RSA.ToXmlString(Boolean) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
Chaîne XML contenant la clé de l'objet RSA actif.
Exceptions
.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 contient uniquement la clé publique de l’objet actuel 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 dans 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écurisée. 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>