RSA.ToXmlString(Boolean) Metoda

Definice

Obor názvů:

System.Security.Cryptography

Sestavení:

System.Security.Cryptography.dll

Zdroj:

RSA.Xml.cs

Vytvoří a vrátí řetězec XML obsahující klíč aktuálního RSA objektu.

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

Parametry

includePrivateParameters

Boolean

true zahrnout veřejný a soukromý klíč RSA; false k zahrnutí pouze veřejného klíče.

Návraty

String

Řetězec XML obsahující klíč aktuálního RSA objektu.

Výjimky

PlatformNotSupportedException

Pouze .NET Core a .NET 5+: Ve všech případech.

Poznámky

Metoda ToXmlString vytvoří řetězec XML, který obsahuje veřejný a privátní klíč aktuálního RSA objektu nebo obsahuje pouze veřejný klíč aktuálního RSA objektu.

Tuto metodu ToXmlString použijte vždy, když potřebujete pohodlně zachovat informace o klíči RSA. Pokud chcete inicializovat RSA objekt s klíčem v řetězci XML, použijte metodu FromXmlString .

Upozornění

Uchování řetězce XML obsahujícího privátní klíč do nezabezpečeného umístění představuje bezpečnostní hrozbu. Zabezpečení vaší aplikace může být ohroženo, pokud k vašemu privátnímu klíči může přistupovat třetí strana se zlými úmysly. Pokud chcete bezpečně zachovat privátní klíč, použijte kontejner zabezpečených klíčů. Další informace o zachování privátních klíčů v kontejneru klíčů najdete v tématu Postupy: Uložení asymetrických klíčů v kontejneru klíčů.

Při předání true do ToXmlString metody má výsledný řetězec XML následující podobu:

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

Při předání false do ToXmlString metody má výsledný řetězec XML následující podobu:

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

Viz také

• Šifrovací služby