X509CertificateLoader.LoadPkcs12FromFile Método

Definición

Espacio de nombres:

System.Security.Cryptography.X509Certificates

Ensamblado:

System.Security.Cryptography.dll

Sobrecargas

LoadPkcs12FromFile(String, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits)	Abre el archivo especificado, lee el contenido como PKCS#12 PFX y extrae un certificado.
LoadPkcs12FromFile(String, String, X509KeyStorageFlags, Pkcs12LoaderLimits)	Abre el archivo especificado, lee el contenido como PKCS#12 PFX y extrae un certificado.

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

Abre el archivo especificado, lee el contenido como PKCS#12 PFX y extrae un certificado.

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

Parámetros

path

String

Ruta de acceso del archivo que se va a abrir.

password

ReadOnlySpan<Char>

Contraseña para descifrar el contenido del PFX.

keyStorageFlags

X509KeyStorageFlags

Combinación bit a bit de los valores de enumeración que controlan dónde y cómo importar la clave privada asociada al certificado devuelto.

loaderLimits

Pkcs12LoaderLimits

Límites que se aplicarán al cargar el PFX. Un valor de null, el valor predeterminado, es equivalente a Defaults.

Devoluciones

X509Certificate2

Certificado cargado.

Excepciones

ArgumentNullException

path es null.

ArgumentException

keyStorageFlags contiene un valor o una combinación de valores que no son válidos.

PlatformNotSupportedException

keyStorageFlags contiene un valor que no es válido para la plataforma actual.

Pkcs12LoadLimitExceededException

PKCS#12/PFX infringía una o varias restricciones de loaderLimits.

CryptographicException

Error al cargar el PKCS#12/PFX.

IOException

Error al cargar el archivo especificado.

Comentarios

Un PKCS#12/PFX puede contener varios certificados. Con el orden en que aparecen los certificados en los resultados de LoadPkcs12CollectionFromFile(String, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits), este método devuelve el primer certificado donde HasPrivateKey es true. Si ningún certificado tiene claves privadas asociadas, se devuelve el primer certificado. Si PKCS#12/PFX no contiene ningún certificado, se produce un CryptographicException.

LoadPkcs12FromFile(String, String, X509KeyStorageFlags, Pkcs12LoaderLimits)

Abre el archivo especificado, lee el contenido como PKCS#12 PFX y extrae un certificado.

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

Parámetros

path

String

Ruta de acceso del archivo que se va a abrir.

password

String

Contraseña para descifrar el contenido del PFX.

keyStorageFlags

X509KeyStorageFlags

Combinación bit a bit de los valores de enumeración que controlan dónde y cómo importar la clave privada asociada al certificado devuelto.

loaderLimits

Pkcs12LoaderLimits

Límites que se aplicarán al cargar el PFX. Un valor de null, el valor predeterminado, es equivalente a Defaults.

Devoluciones

X509Certificate2

Certificado cargado.

Excepciones

ArgumentNullException

path es null.

ArgumentException

keyStorageFlags contiene un valor o una combinación de valores que no son válidos.

PlatformNotSupportedException

keyStorageFlags contiene un valor que no es válido para la plataforma actual.

Pkcs12LoadLimitExceededException

PKCS#12/PFX infringía una o varias restricciones de loaderLimits.

CryptographicException

Error al cargar el PKCS#12/PFX.

IOException

Error al cargar el archivo especificado.

Comentarios

Un PKCS#12/PFX puede contener varios certificados. Con el orden en que aparecen los certificados en los resultados de LoadPkcs12CollectionFromFile(String, String, X509KeyStorageFlags, Pkcs12LoaderLimits), este método devuelve el primer certificado donde HasPrivateKey es true. Si ningún certificado tiene claves privadas asociadas, se devuelve el primer certificado. Si PKCS#12/PFX no contiene ningún certificado, se produce un CryptographicException.