RSA.ToXmlString(Boolean) Метод

Определение

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

System.Security.Cryptography

Сборка:

System.Security.Cryptography.Algorithms.dll

Сборка:

System.Security.Cryptography.dll

Сборка:

mscorlib.dll

Сборка:

netstandard.dll

Создает и возвращает строку 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>  

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

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