X509CertificateLoader.LoadPkcs12FromFile Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
LoadPkcs12FromFile(String, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits) |
Ouvre le fichier spécifié, lit le contenu sous la forme d’un PFX PKCS#12 et extrait un certificat. |
LoadPkcs12FromFile(String, String, X509KeyStorageFlags, Pkcs12LoaderLimits) |
Ouvre le fichier spécifié, lit le contenu sous la forme d’un PFX PKCS#12 et extrait un certificat. |
LoadPkcs12FromFile(String, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits)
- Source:
- X509CertificateLoader.cs
- Source:
- X509CertificateLoader.cs
Ouvre le fichier spécifié, lit le contenu sous la forme d’un PFX PKCS#12 et extrait un certificat.
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
Paramètres
- path
- String
Chemin d’accès du fichier à ouvrir.
- password
- ReadOnlySpan<Char>
Mot de passe pour déchiffrer le contenu du PFX.
- keyStorageFlags
- X509KeyStorageFlags
Combinaison de bits des valeurs d’énumération qui contrôlent où et comment importer la clé privée associée au certificat retourné.
- loaderLimits
- Pkcs12LoaderLimits
Limites à appliquer lors du chargement du PFX. Une valeur null
, la valeur par défaut, équivaut à Defaults.
Retours
Certificat chargé.
Exceptions
path
est null
.
keyStorageFlags
contient une valeur ou une combinaison de valeurs qui n’est pas valide.
keyStorageFlags
contient une valeur qui n’est pas valide pour la plateforme actuelle.
Le PKCS#12/PFX a violé une ou plusieurs contraintes de loaderLimits
.
Une erreur s’est produite lors du chargement de PKCS#12/PFX.
Une erreur s’est produite lors du chargement du fichier spécifié.
Remarques
Un PKCS#12/PFX peut contenir plusieurs certificats. À l’aide de l’ordre dans lequel les certificats apparaissent dans les résultats de LoadPkcs12CollectionFromFile(String, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits), cette méthode retourne le premier certificat où HasPrivateKey est true
. Si aucun certificat n’a de clés privées associées, le premier certificat est retourné. Si PKCS#12/PFX ne contient aucun certificat, une CryptographicException est levée.
S’applique à
LoadPkcs12FromFile(String, String, X509KeyStorageFlags, Pkcs12LoaderLimits)
- Source:
- X509CertificateLoader.cs
- Source:
- X509CertificateLoader.cs
Ouvre le fichier spécifié, lit le contenu sous la forme d’un PFX PKCS#12 et extrait un certificat.
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
Paramètres
- path
- String
Chemin d’accès du fichier à ouvrir.
- password
- String
Mot de passe pour déchiffrer le contenu du PFX.
- keyStorageFlags
- X509KeyStorageFlags
Combinaison de bits des valeurs d’énumération qui contrôlent où et comment importer la clé privée associée au certificat retourné.
- loaderLimits
- Pkcs12LoaderLimits
Limites à appliquer lors du chargement du PFX. Une valeur null
, la valeur par défaut, équivaut à Defaults.
Retours
Certificat chargé.
Exceptions
path
est null
.
keyStorageFlags
contient une valeur ou une combinaison de valeurs qui n’est pas valide.
keyStorageFlags
contient une valeur qui n’est pas valide pour la plateforme actuelle.
Le PKCS#12/PFX a violé une ou plusieurs contraintes de loaderLimits
.
Une erreur s’est produite lors du chargement de PKCS#12/PFX.
Une erreur s’est produite lors du chargement du fichier spécifié.
Remarques
Un PKCS#12/PFX peut contenir plusieurs certificats. À l’aide de l’ordre dans lequel les certificats apparaissent dans les résultats de LoadPkcs12CollectionFromFile(String, String, X509KeyStorageFlags, Pkcs12LoaderLimits), cette méthode retourne le premier certificat où HasPrivateKey est true
. Si aucun certificat n’a de clés privées associées, le premier certificat est retourné. Si PKCS#12/PFX ne contient aucun certificat, une CryptographicException est levée.