RSA.ToXmlString(Boolean) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Tworzy i zwraca ciąg XML zawierający klucz bieżącego RSA obiektu.
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
do uwzględnienia publicznego i prywatnego klucza RSA; false
w celu uwzględnienia tylko klucza publicznego.
Zwraca
Ciąg XML zawierający klucz bieżącego RSA obiektu.
Wyjątki
Tylko platformy .NET Core i .NET 5+: we wszystkich przypadkach.
Uwagi
Metoda ToXmlString tworzy ciąg XML zawierający publiczny i prywatny klucz bieżącego RSA obiektu lub zawiera tylko klucz publiczny bieżącego RSA obiektu.
ToXmlString Użyj metody za każdym razem, gdy trzeba wygodnie utrwalać informacje o kluczu RSA. Aby zainicjować RSA obiekt za pomocą klucza w ciągu XML, użyj FromXmlString metody .
Przestroga
Utrwalanie ciągu XML zawierającego klucz prywatny do niezabezpieczonej lokalizacji jest zagrożeniem bezpieczeństwa. Bezpieczeństwo aplikacji może zostać naruszone, jeśli złośliwa osoba trzecia może uzyskać dostęp do klucza prywatnego. Aby bezpiecznie zachować klucz prywatny, należy użyć bezpiecznego kontenera kluczy. Aby uzyskać więcej informacji na temat utrwalania kluczy prywatnych w kontenerze kluczy, zobacz Instrukcje: przechowywanie kluczy asymetrycznych w kontenerze kluczy.
Po przekazaniu true
ToXmlString do metody wynikowy ciąg XML ma następującą formę:
<RSAKeyValue>
<Modulus>…</Modulus>
<Exponent>…</Exponent>
<P>…</P>
<Q>…</Q>
<DP>…</DP>
<DQ>…</DQ>
<InverseQ>…</InverseQ>
<D>…</D>
</RSAKeyValue>
Po przekazaniu false
ToXmlString do metody wynikowy ciąg XML ma następującą formę:
<RSAKeyValue>
<Modulus>…</Modulus>
<Exponent>…</Exponent>
</RSAKeyValue>