Бөлісу құралы:

X509CertificateLoader.LoadPkcs12FromFile Метод

  • Ссылка

Определение

Пространство имен:
System.Security.Cryptography.X509Certificates
Сборка:
Microsoft.Bcl.Cryptography.dll
Сборка:
System.Security.Cryptography.dll
Пакет:
Microsoft.Bcl.Cryptography v9.0.0-rc.2.24473.5

Перегрузки

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.X509Certificate2
Public 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.

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

X509Certificate2

Загруженный сертификат.

Исключения

ArgumentNullException

path null.

ArgumentException

keyStorageFlags содержит значение или сочетание значений, которое недопустимо.

PlatformNotSupportedException

keyStorageFlags содержит значение, недопустимое для текущей платформы.

Pkcs12LoadLimitExceededException

PKCS#12/PFX нарушил одно или несколько ограничений loaderLimits.

CryptographicException

Произошла ошибка при загрузке PKCS#12/PFX.

IOException

Произошла ошибка при загрузке указанного файла.

Комментарии

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.X509Certificate2
Public 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.

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

X509Certificate2

Загруженный сертификат.

Исключения

ArgumentNullException

path null.

ArgumentException

keyStorageFlags содержит значение или сочетание значений, которое недопустимо.

PlatformNotSupportedException

keyStorageFlags содержит значение, недопустимое для текущей платформы.

Pkcs12LoadLimitExceededException

PKCS#12/PFX нарушил одно или несколько ограничений loaderLimits.

CryptographicException

Произошла ошибка при загрузке PKCS#12/PFX.

IOException

Произошла ошибка при загрузке указанного файла.

Комментарии

PKCS#12/PFX может содержать несколько сертификатов. Используя порядок, который сертификаты отображаются в результатах LoadPkcs12CollectionFromFile(String, String, X509KeyStorageFlags, Pkcs12LoaderLimits), этот метод возвращает первый сертификат, в котором HasPrivateKeytrue. Если сертификаты не имеют связанных закрытых ключей, возвращается первый сертификат. Если PKCS#12/PFX не содержит сертификатов, создается CryptographicException.

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