X509CertificateLoader.LoadPkcs12FromFile Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| LoadPkcs12FromFile(String, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits) |
Abre o arquivo especificado, lê o conteúdo como um PFX PKCS nº 12 e extrai um certificado. |
| LoadPkcs12FromFile(String, String, X509KeyStorageFlags, Pkcs12LoaderLimits) |
Abre o arquivo especificado, lê o conteúdo como um PFX PKCS nº 12 e extrai um certificado. |
LoadPkcs12FromFile(String, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits)
- Origem:
- X509CertificateLoader.cs
- Origem:
- X509CertificateLoader.cs
Abre o arquivo especificado, lê o conteúdo como um PFX PKCS nº 12 e extrai um 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.X509Certificate2Public 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 X509Certificate2Parâmetros
- path
- String
O caminho do arquivo a ser aberto.
- password
- ReadOnlySpan<Char>
A senha para descriptografar o conteúdo do PFX.
- keyStorageFlags
- X509KeyStorageFlags
Uma combinação bit a bit dos valores de enumeração que controlam onde e como importar a chave privada associada ao certificado retornado.
- loaderLimits
- Pkcs12LoaderLimits
Limites a serem aplicados ao carregar o PFX. Um valor null, o padrão, é equivalente a Defaults.
Retornos
O certificado carregado.
Exceções
path é null.
keyStorageFlags contém um valor ou uma combinação de valores que não é válido.
keyStorageFlags contém um valor que não é válido para a plataforma atual.
O PKCS nº 12/PFX violou uma ou mais restrições de loaderLimits.
Erro ao carregar o PKCS nº 12/PFX.
Erro ao carregar o arquivo especificado.
Comentários
Um PKCS#12/PFX pode conter vários certificados. Usando a ordenação que os certificados aparecem nos resultados de LoadPkcs12CollectionFromFile(String, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits), esse método retorna o primeiro certificado em que HasPrivateKey é true. Se nenhum certificado tiver chaves privadas associadas, o primeiro certificado será retornado. Se o PKCS nº 12/PFX não contiver certificados, um CryptographicException será gerado.
Aplica-se a
LoadPkcs12FromFile(String, String, X509KeyStorageFlags, Pkcs12LoaderLimits)
- Origem:
- X509CertificateLoader.cs
- Origem:
- X509CertificateLoader.cs
Abre o arquivo especificado, lê o conteúdo como um PFX PKCS nº 12 e extrai um 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.X509Certificate2Public 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 X509Certificate2Parâmetros
- path
- String
O caminho do arquivo a ser aberto.
- password
- String
A senha para descriptografar o conteúdo do PFX.
- keyStorageFlags
- X509KeyStorageFlags
Uma combinação bit a bit dos valores de enumeração que controlam onde e como importar a chave privada associada ao certificado retornado.
- loaderLimits
- Pkcs12LoaderLimits
Limites a serem aplicados ao carregar o PFX. Um valor null, o padrão, é equivalente a Defaults.
Retornos
O certificado carregado.
Exceções
path é null.
keyStorageFlags contém um valor ou uma combinação de valores que não é válido.
keyStorageFlags contém um valor que não é válido para a plataforma atual.
O PKCS nº 12/PFX violou uma ou mais restrições de loaderLimits.
Erro ao carregar o PKCS nº 12/PFX.
Erro ao carregar o arquivo especificado.
Comentários
Um PKCS#12/PFX pode conter vários certificados. Usando a ordenação que os certificados aparecem nos resultados de LoadPkcs12CollectionFromFile(String, String, X509KeyStorageFlags, Pkcs12LoaderLimits), esse método retorna o primeiro certificado em que HasPrivateKey é true. Se nenhum certificado tiver chaves privadas associadas, o primeiro certificado será retornado. Se o PKCS nº 12/PFX não contiver certificados, um CryptographicException será gerado.
