RSA.ToXmlString(Boolean) Метод

Определение

Пространство имен:

System.Security.Cryptography

Сборка:

System.Security.Cryptography.dll

Исходный код:

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>

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

• службы шифрования