RSA.ToXmlString(Boolean) Метод

Определение

Пространство имен:
System.Security.Cryptography
Сборки:
netstandard.dll, System.Security.Cryptography.dll
Сборки:
netstandard.dll, System.Security.Cryptography.Algorithms.dll
Сборка:
System.Security.Cryptography.Algorithms.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.dll
Исходный код:
RSA.Xml.cs
Исходный код:
RSA.Xml.cs
Исходный код:
RSA.Xml.cs
Исходный код:
RSA.Xml.cs
Исходный код:
RSA.Xml.cs

Создает и возвращает XML-строку, содержащую ключ текущего RSA объекта.

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

Параметры

includePrivateParameters
Boolean

true для включения открытого и закрытого ключа RSA; false для включения только открытого ключа.

Возвращаемое значение

String

XML-строка, содержащая ключ текущего RSA объекта.

Исключения

PlatformNotSupportedException

Только .NET Core и .NET 5+ : во всех случаях.

Комментарии

Метод ToXmlString создает XML-строку, содержащую открытый и закрытый ключ текущего RSA объекта или содержащий только открытый ключ текущего RSA объекта.

Используйте этот метод всякий ToXmlString раз, когда необходимо удобно сохранять сведения о ключе RSA. Чтобы инициализировать RSA объект с ключом в XML-строке, используйте FromXmlString метод.

Предостережение

Сохранение XML-строки, содержащей закрытый ключ в небезопасном расположении, является угрозой безопасности. Безопасность приложения может быть скомпрометирована, если злоумышленник может получить доступ к закрытому ключу. Чтобы безопасно сохранить закрытый ключ, используйте контейнер безопасного ключа. Дополнительные сведения о сохранении закрытых ключей в контейнере ключей см. в разделе "Практическое руководство. Хранение асимметричных ключей в контейнере ключей".

При передаче true в ToXmlString метод результирующая XML-строка принимает следующую форму:

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

При передаче false в ToXmlString метод результирующая XML-строка принимает следующую форму:

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

Применяется к

См. также раздел