X509CertificateLoader.LoadPkcs12FromFile Metoda
Definicja
Ważny
Niektóre informacje dotyczą produktów przedpremierowych, które mogą zostać znacznie zmodyfikowane przed premierą. Microsoft nie udziela żadnych gwarancji, ani wyraźnych, ani domniemanych, dotyczących informacji podanych tutaj.
Przeciążenia
| Nazwa | Opis |
|---|---|
| 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)
- Źródło:
- X509CertificateLoader.cs
- Źródło:
- X509CertificateLoader.cs
- Źródło:
- X509CertificateLoader.cs
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
Załadowany certyfikat.
Wyjątki
path jest null.
keyStorageFlags zawiera wartość lub kombinację wartości, które są nieprawidłowe.
keyStorageFlags zawiera wartość nieprawidłową dla bieżącej platformy.
PKCS#12/PFX naruszył co najmniej jedno ograniczenie loaderLimits.
Wystąpił błąd podczas ładowania PKCS#12/PFX.
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.
Dotyczy
LoadPkcs12FromFile(String, String, X509KeyStorageFlags, Pkcs12LoaderLimits)
- Źródło:
- X509CertificateLoader.cs
- Źródło:
- X509CertificateLoader.cs
- Źródło:
- X509CertificateLoader.cs
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
Załadowany certyfikat.
Wyjątki
path jest null.
keyStorageFlags zawiera wartość lub kombinację wartości, które są nieprawidłowe.
keyStorageFlags zawiera wartość nieprawidłową dla bieżącej platformy.
PKCS#12/PFX naruszył co najmniej jedno ograniczenie loaderLimits.
Wystąpił błąd podczas ładowania PKCS#12/PFX.
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.