RSA.ToXmlString(Boolean) Methode

Definition

Namespace:

System.Security.Cryptography

Assembly:

System.Security.Cryptography.dll

Quelle:

RSA.Xml.cs

Erstellt eine XML-Zeichenfolge mit dem Schlüssel des aktuellen RSA-Objekts und gibt diese zurück.

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

Parameter

includePrivateParameters

Boolean

true, um einen öffentlichen und einen privaten RSA-Schlüssel einzuschließen. false, um nur den öffentlichen Schlüssel einzuschließen.

Gibt zurück

String

Eine XML-Zeichenfolge mit dem Schlüssel des aktuellen RSA-Objekts.

Ausnahmen

PlatformNotSupportedException

Nur .NET Core und .NET 5 und höher: In allen Fällen.

Hinweise

Die ToXmlString -Methode erstellt eine XML-Zeichenfolge, die entweder den öffentlichen und privaten Schlüssel des aktuellen RSA Objekts oder nur den öffentlichen Schlüssel des aktuellen RSA Objekts enthält.

Verwenden Sie die ToXmlString -Methode immer dann, wenn Sie RSA-Schlüsselinformationen bequem beibehalten müssen. Verwenden Sie die FromXmlString -Methode, um ein RSA Objekt mit dem Schlüssel in einer XML-Zeichenfolge zu initialisieren.

Achtung

Das Beibehalten einer XML-Zeichenfolge mit einem privaten Schlüssel an einem unsicheren Speicherort stellt eine Sicherheitsbedrohung dar. Die Sicherheit Ihrer Anwendung kann gefährdet werden, wenn ein böswilliger Dritter auf Ihren privaten Schlüssel zugreifen kann. Um einen privaten Schlüssel sicher zu speichern, verwenden Sie einen Container mit sicherem Schlüssel. Weitere Informationen zum Beibehalten privater Schlüssel in einem Schlüsselcontainer finden Sie unter Vorgehensweise: Speichern asymmetrischer Schlüssel in einem Schlüsselcontainer.

Wenn Sie an die ToXmlString -Methode übergebentrue, hat die resultierende XML-Zeichenfolge die folgende Form:

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

Wenn Sie an die ToXmlString -Methode übergebenfalse, hat die resultierende XML-Zeichenfolge die folgende Form:

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

Weitere Informationen

• Kryptografische Dienste