X509CertificateLoader.LoadPkcs12FromFile Metoda

Definicja

Przestrzeń nazw:

System.Security.Cryptography.X509Certificates

Zestaw:

System.Security.Cryptography.dll

Przeciążenia

LoadPkcs12FromFile(String, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits)	Otwiera określony plik, odczytuje zawartość jako plik PFX PKCS#12 i wyodrębnia certyfikat.
LoadPkcs12FromFile(String, String, X509KeyStorageFlags, Pkcs12LoaderLimits)	Otwiera określony plik, odczytuje zawartość jako plik PFX PKCS#12 i wyodrębnia certyfikat.

LoadPkcs12FromFile(String, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits)

Otwiera określony plik, odczytuje zawartość jako plik PFX PKCS#12 i wyodrębnia certyfikat.

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

Parametry

path

String

Ścieżka pliku do otwarcia.

password

ReadOnlySpan<Char>

Hasło do odszyfrowywania zawartości pliku PFX.

keyStorageFlags

X509KeyStorageFlags

Bitowa kombinacja wartości wyliczenia kontrolujących miejsce i sposób importowania klucza prywatnego skojarzonego z zwróconym certyfikatem.

loaderLimits

Pkcs12LoaderLimits

Limity, które mają być stosowane podczas ładowania pliku PFX. Wartość domyślna null jest równoważna Defaults.

Zwraca

X509Certificate2

Załadowany certyfikat.

Wyjątki

ArgumentNullException

path jest null.

ArgumentException

keyStorageFlags zawiera wartość lub kombinację wartości, które są nieprawidłowe.

PlatformNotSupportedException

keyStorageFlags zawiera wartość nieprawidłową dla bieżącej platformy.

Pkcs12LoadLimitExceededException

PKCS#12/PFX naruszył co najmniej jedno ograniczenie loaderLimits.

CryptographicException

Wystąpił błąd podczas ładowania PKCS#12/PFX.

IOException

Wystąpił błąd podczas ładowania określonego pliku.

Uwagi

PKCS#12/PFX może zawierać wiele certyfikatów. Używając kolejności, w której certyfikaty są wyświetlane w wynikach LoadPkcs12CollectionFromFile(String, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits), ta metoda zwraca pierwszy certyfikat, w którym HasPrivateKey jest true. Jeśli żadne certyfikaty nie mają skojarzonych kluczy prywatnych, zwracany jest pierwszy certyfikat. Jeśli PKCS#12/PFX nie zawiera żadnych certyfikatów, zostanie zgłoszony CryptographicException.

LoadPkcs12FromFile(String, String, X509KeyStorageFlags, Pkcs12LoaderLimits)

Otwiera określony plik, odczytuje zawartość jako plik PFX PKCS#12 i wyodrębnia certyfikat.

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

Parametry

path

String

Ścieżka pliku do otwarcia.

password

String

Hasło do odszyfrowywania zawartości pliku PFX.

keyStorageFlags

X509KeyStorageFlags

Bitowa kombinacja wartości wyliczenia kontrolujących miejsce i sposób importowania klucza prywatnego skojarzonego z zwróconym certyfikatem.

loaderLimits

Pkcs12LoaderLimits

Limity, które mają być stosowane podczas ładowania pliku PFX. Wartość domyślna null jest równoważna Defaults.

Zwraca

X509Certificate2

Załadowany certyfikat.

Wyjątki

ArgumentNullException

path jest null.

ArgumentException

keyStorageFlags zawiera wartość lub kombinację wartości, które są nieprawidłowe.

PlatformNotSupportedException

keyStorageFlags zawiera wartość nieprawidłową dla bieżącej platformy.

Pkcs12LoadLimitExceededException

PKCS#12/PFX naruszył co najmniej jedno ograniczenie loaderLimits.

CryptographicException

Wystąpił błąd podczas ładowania PKCS#12/PFX.

IOException

Wystąpił błąd podczas ładowania określonego pliku.

Uwagi

PKCS#12/PFX może zawierać wiele certyfikatów. Używając kolejności, w której certyfikaty są wyświetlane w wynikach LoadPkcs12CollectionFromFile(String, String, X509KeyStorageFlags, Pkcs12LoaderLimits), ta metoda zwraca pierwszy certyfikat, w którym HasPrivateKey jest true. Jeśli żadne certyfikaty nie mają skojarzonych kluczy prywatnych, zwracany jest pierwszy certyfikat. Jeśli PKCS#12/PFX nie zawiera żadnych certyfikatów, zostanie zgłoszony CryptographicException.