X509CertificateLoader.LoadPkcs12FromFile Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| LoadPkcs12FromFile(String, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits) |
Открывает указанный файл, считывает содержимое в виде PKCS#12 PFX и извлекает сертификат. |
| LoadPkcs12FromFile(String, String, X509KeyStorageFlags, Pkcs12LoaderLimits) |
Открывает указанный файл, считывает содержимое в виде PKCS#12 PFX и извлекает сертификат. |
LoadPkcs12FromFile(String, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits)
- Исходный код:
- X509CertificateLoader.cs
Открывает указанный файл, считывает содержимое в виде PKCS#12 PFX и извлекает сертификат.
public static System.Security.Cryptography.X509Certificates.X509Certificate2 LoadPkcs12FromFile (string path, ReadOnlySpan<char> password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet, System.Security.Cryptography.X509Certificates.Pkcs12LoaderLimits? loaderLimits = default);static member LoadPkcs12FromFile : string * ReadOnlySpan<char> * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags * System.Security.Cryptography.X509Certificates.Pkcs12LoaderLimits -> System.Security.Cryptography.X509Certificates.X509Certificate2Public Shared Function LoadPkcs12FromFile (path As String, password As ReadOnlySpan(Of Char), Optional keyStorageFlags As X509KeyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet, Optional loaderLimits As Pkcs12LoaderLimits = Nothing) As X509Certificate2Параметры
- path
- String
Путь к открытому файлу.
- password
- ReadOnlySpan<Char>
Пароль для расшифровки содержимого PFX.
- keyStorageFlags
- X509KeyStorageFlags
Побитовое сочетание значений перечисления, которые управляют местом и как импортировать закрытый ключ, связанный с возвращенным сертификатом.
- loaderLimits
- Pkcs12LoaderLimits
Ограничения, применяемые при загрузке PFX. Значение null по умолчанию эквивалентно Defaults.
Возвращаемое значение
Загруженный сертификат.
Исключения
path
null.
keyStorageFlags содержит значение или сочетание значений, которое недопустимо.
keyStorageFlags содержит значение, недопустимое для текущей платформы.
PKCS#12/PFX нарушил одно или несколько ограничений loaderLimits.
Произошла ошибка при загрузке PKCS#12/PFX.
Произошла ошибка при загрузке указанного файла.
Комментарии
PKCS#12/PFX может содержать несколько сертификатов. Используя порядок, который сертификаты отображаются в результатах LoadPkcs12CollectionFromFile(String, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits), этот метод возвращает первый сертификат, в котором HasPrivateKeytrue. Если сертификаты не имеют связанных закрытых ключей, возвращается первый сертификат. Если PKCS#12/PFX не содержит сертификатов, создается CryptographicException.
Применяется к
LoadPkcs12FromFile(String, String, X509KeyStorageFlags, Pkcs12LoaderLimits)
- Исходный код:
- X509CertificateLoader.cs
Открывает указанный файл, считывает содержимое в виде PKCS#12 PFX и извлекает сертификат.
public static System.Security.Cryptography.X509Certificates.X509Certificate2 LoadPkcs12FromFile (string path, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet, System.Security.Cryptography.X509Certificates.Pkcs12LoaderLimits? loaderLimits = default);static member LoadPkcs12FromFile : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags * System.Security.Cryptography.X509Certificates.Pkcs12LoaderLimits -> System.Security.Cryptography.X509Certificates.X509Certificate2Public Shared Function LoadPkcs12FromFile (path As String, password As String, Optional keyStorageFlags As X509KeyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet, Optional loaderLimits As Pkcs12LoaderLimits = Nothing) As X509Certificate2Параметры
- path
- String
Путь к открытому файлу.
- password
- String
Пароль для расшифровки содержимого PFX.
- keyStorageFlags
- X509KeyStorageFlags
Побитовое сочетание значений перечисления, которые управляют местом и как импортировать закрытый ключ, связанный с возвращенным сертификатом.
- loaderLimits
- Pkcs12LoaderLimits
Ограничения, применяемые при загрузке PFX. Значение null по умолчанию эквивалентно Defaults.
Возвращаемое значение
Загруженный сертификат.
Исключения
path
null.
keyStorageFlags содержит значение или сочетание значений, которое недопустимо.
keyStorageFlags содержит значение, недопустимое для текущей платформы.
PKCS#12/PFX нарушил одно или несколько ограничений loaderLimits.
Произошла ошибка при загрузке PKCS#12/PFX.
Произошла ошибка при загрузке указанного файла.
Комментарии
PKCS#12/PFX может содержать несколько сертификатов. Используя порядок, который сертификаты отображаются в результатах LoadPkcs12CollectionFromFile(String, String, X509KeyStorageFlags, Pkcs12LoaderLimits), этот метод возвращает первый сертификат, в котором HasPrivateKeytrue. Если сертификаты не имеют связанных закрытых ключей, возвращается первый сертификат. Если PKCS#12/PFX не содержит сертификатов, создается CryptographicException.
