X509CertificateLoader.LoadPkcs12FromFile Metoda

Definice

Obor názvů:

System.Security.Cryptography.X509Certificates

Sestavení:

System.Security.Cryptography.dll

Přetížení

LoadPkcs12FromFile(String, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits)	Otevře zadaný soubor, přečte obsah jako PKCS#12 PFX a extrahuje certifikát.
LoadPkcs12FromFile(String, String, X509KeyStorageFlags, Pkcs12LoaderLimits)	Otevře zadaný soubor, přečte obsah jako PKCS#12 PFX a extrahuje certifikát.

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

Otevře zadaný soubor, přečte obsah jako PKCS#12 PFX a extrahuje certifikát.

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

Cesta k souboru, který se má otevřít.

password

ReadOnlySpan<Char>

Heslo k dešifrování obsahu PFX.

keyStorageFlags

X509KeyStorageFlags

Bitové kombinace hodnot výčtu, které řídí, kde a jak importovat privátní klíč přidružený k vráceným certifikátu.

loaderLimits

Pkcs12LoaderLimits

Omezení, která se mají použít při načítání PFX. Výchozí hodnota null odpovídá Defaults.

Návraty

X509Certificate2

Načtený certifikát.

Výjimky

ArgumentNullException

path je null.

ArgumentException

keyStorageFlags obsahuje hodnotu nebo kombinaci hodnot, která není platná.

PlatformNotSupportedException

keyStorageFlags obsahuje hodnotu, která není platná pro aktuální platformu.

Pkcs12LoadLimitExceededException

PkCS#12/PFX porušila jedno nebo více omezení loaderLimits.

CryptographicException

Při načítání PKCS#12/PFX došlo k chybě.

IOException

Při načítání zadaného souboru došlo k chybě.

Poznámky

PKCS#12/PFX může obsahovat více certifikátů. Pomocí řazení, které se certifikáty zobrazí ve výsledcích LoadPkcs12CollectionFromFile(String, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits), tato metoda vrátí první certifikát, kde HasPrivateKey je true. Pokud žádné certifikáty nemají přidružené privátní klíče, vrátí se první certifikát. Pokud PKCS#12/PFX neobsahuje žádné certifikáty, vyvolá se CryptographicException.

LoadPkcs12FromFile(String, String, X509KeyStorageFlags, Pkcs12LoaderLimits)

Otevře zadaný soubor, přečte obsah jako PKCS#12 PFX a extrahuje certifikát.

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

Cesta k souboru, který se má otevřít.

password

String

Heslo k dešifrování obsahu PFX.

keyStorageFlags

X509KeyStorageFlags

Bitové kombinace hodnot výčtu, které řídí, kde a jak importovat privátní klíč přidružený k vráceným certifikátu.

loaderLimits

Pkcs12LoaderLimits

Omezení, která se mají použít při načítání PFX. Výchozí hodnota null odpovídá Defaults.

Návraty

X509Certificate2

Načtený certifikát.

Výjimky

ArgumentNullException

path je null.

ArgumentException

keyStorageFlags obsahuje hodnotu nebo kombinaci hodnot, která není platná.

PlatformNotSupportedException

keyStorageFlags obsahuje hodnotu, která není platná pro aktuální platformu.

Pkcs12LoadLimitExceededException

PkCS#12/PFX porušila jedno nebo více omezení loaderLimits.

CryptographicException

Při načítání PKCS#12/PFX došlo k chybě.

IOException

Při načítání zadaného souboru došlo k chybě.

Poznámky

PKCS#12/PFX může obsahovat více certifikátů. Pomocí řazení, které se certifikáty zobrazí ve výsledcích LoadPkcs12CollectionFromFile(String, String, X509KeyStorageFlags, Pkcs12LoaderLimits), tato metoda vrátí první certifikát, kde HasPrivateKey je true. Pokud žádné certifikáty nemají přidružené privátní klíče, vrátí se první certifikát. Pokud PKCS#12/PFX neobsahuje žádné certifikáty, vyvolá se CryptographicException.