X509Certificate2.CreateFromPem Метод

Определение

Перегрузки

CreateFromPem(ReadOnlySpan<Char>)

Создает новый сертификат X509 из содержимого сертификата в кодировке RFC 7468, закодированного в формате PEM.

CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>)

Создает новый сертификат X.509 на основе содержимого сертификата RFC 7468 в кодировке PEM и закрытый ключ.

CreateFromPem(ReadOnlySpan<Char>)

Создает новый сертификат X509 из содержимого сертификата в кодировке RFC 7468, закодированного в формате PEM.

public:
 static System::Security::Cryptography::X509Certificates::X509Certificate2 ^ CreateFromPem(ReadOnlySpan<char> certPem);
public static System.Security.Cryptography.X509Certificates.X509Certificate2 CreateFromPem (ReadOnlySpan<char> certPem);
static member CreateFromPem : ReadOnlySpan<char> -> System.Security.Cryptography.X509Certificates.X509Certificate2
Public Shared Function CreateFromPem (certPem As ReadOnlySpan(Of Char)) As X509Certificate2

Параметры

certPem
ReadOnlySpan<Char>

Текст сертификата X.509 в кодировке PEM.

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

X509Certificate2

Новый сертификат X509.

Исключения

Содержимое certPem не содержит сертификат в кодировке PEM или имеет неправильный формат.

Комментарии

При этом загружается первый правильно сформированный PEM с меткой сертификата.

Для сертификатов в кодировке PEM с закрытым ключом используйте CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>) .

Для сертификатов, закодированных PEM в файле, используйте X509Certificate2(String) .

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

CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>)

Создает новый сертификат X.509 на основе содержимого сертификата RFC 7468 в кодировке PEM и закрытый ключ.

public:
 static System::Security::Cryptography::X509Certificates::X509Certificate2 ^ CreateFromPem(ReadOnlySpan<char> certPem, ReadOnlySpan<char> keyPem);
public static System.Security.Cryptography.X509Certificates.X509Certificate2 CreateFromPem (ReadOnlySpan<char> certPem, ReadOnlySpan<char> keyPem);
static member CreateFromPem : ReadOnlySpan<char> * ReadOnlySpan<char> -> System.Security.Cryptography.X509Certificates.X509Certificate2
Public Shared Function CreateFromPem (certPem As ReadOnlySpan(Of Char), keyPem As ReadOnlySpan(Of Char)) As X509Certificate2

Параметры

certPem
ReadOnlySpan<Char>

Текст сертификата X.509 в кодировке PEM.

keyPem
ReadOnlySpan<Char>

Текст закрытого ключа в кодировке PEM.

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

X509Certificate2

Новый сертификат с закрытым ключом.

Исключения

Содержимое certPem не содержит сертификат в кодировке PEM или имеет неправильный формат.

-или-

Содержимое keyPem не содержит закрытый ключ в кодировке PEM или имеет неправильный формат.

-или-

Содержимое keyPem содержит ключ, который не соответствует открытому ключу в сертификате.

-или-

Сертификат использует неизвестный алгоритм открытого ключа.

Комментарии

Субжектпубликкэйинфо из сертификата определяет, какие метки PEM принимаются для закрытого ключа. Для сертификатов RSA допустимые метки PEM закрытого ключа: "закрытый ключ RSA" и "закрытый ключ". Для сертификатов ECDSA допустимые метки PEM закрытого ключа: "EC закрытый ключ" и "закрытый ключ". Для сертификатов DSA принятая метка PEM закрытого ключа — "закрытый ключ".

Элементы в кодировке PEM с разными метками игнорируются.

Если сертификат в кодировке PEM и закрытый ключ находятся в одном и том же тексте, используйте одну и ту же строку для certPem и keyPem , например CreateFromPem(combinedCertAndKey, combinedCertAndKey); . Объединенные сертификаты и ключи в кодировке PEM не нуждаются в определенном порядке. Для сертификата загружается первый сертификат с меткой сертификата. Для закрытого ключа загружается первый закрытый ключ с допустимой меткой. Более сложные сценарии для загрузки сертификатов и закрытых ключей могут использовать PemEncoding для перечисления значений в кодировке PEM и применения любых пользовательских функций загрузки.

Для защищенных паролем ключей в кодировке PEM используйте CreateFromEncryptedPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>, ReadOnlySpan<Char>) для указания пароля.

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