Прочитать на английском

Поделиться через


RSA.ToXmlString(Boolean) Метод

Определение

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

public override string ToXmlString(bool includePrivateParameters);

Параметры

includePrivateParameters
Boolean

Значение true, чтобы включать закрытый и открытый ключ RSA; значение false, чтобы включать только открытый ключ.

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

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

Исключения

Только .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>

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

Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

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