X509CertificateLoader.LoadPkcs12FromFile Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Sobrecargas
| Name | Description |
|---|---|
| LoadPkcs12FromFile(String, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits) |
Abre o ficheiro especificado, lê o conteúdo como um PFX PKCS#12 e extrai um certificado. |
| LoadPkcs12FromFile(String, String, X509KeyStorageFlags, Pkcs12LoaderLimits) |
Abre o ficheiro especificado, lê o conteúdo como um PFX PKCS#12 e extrai um certificado. |
LoadPkcs12FromFile(String, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits)
- Origem:
- X509CertificateLoader.cs
- Origem:
- X509CertificateLoader.cs
- Origem:
- X509CertificateLoader.cs
- Origem:
- X509CertificateLoader.cs
- Origem:
- X509CertificateLoader.cs
Abre o ficheiro especificado, lê o conteúdo como um PFX PKCS#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 ficheiro para abrir.
- password
- ReadOnlySpan<Char>
A palavra-passe para desencriptar 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 devolvido.
- loaderLimits
- Pkcs12LoaderLimits
Limites a aplicar ao carregar o PFX. Um null valor, o padrão, é equivalente a Defaults.
Devoluções
O certificado carregado.
Exceções
path é null.
keyStorageFlags contém um valor, ou combinação de valores, que não é válida.
keyStorageFlags contém um valor que não é válido para a plataforma atual.
O PKCS#12/PFX violava uma ou mais restrições de loaderLimits.
Ocorreu um erro durante o carregamento do PKCS#12/PFX.
Ocorreu um erro durante o carregamento do ficheiro especificado.
Observações
Um PKCS#12/PFX pode conter múltiplos certificados. Usando a ordem em que os certificados aparecem nos resultados de LoadPkcs12CollectionFromFile(String, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits), este método devolve o primeiro certificado onde HasPrivateKey é true. Se nenhum certificado tiver chaves privadas associadas, então o primeiro certificado é devolvido. Se o PKCS#12/PFX não contiver certificados, a CryptographicException é lançado.
Aplica-se a
LoadPkcs12FromFile(String, String, X509KeyStorageFlags, Pkcs12LoaderLimits)
- Origem:
- X509CertificateLoader.cs
- Origem:
- X509CertificateLoader.cs
- Origem:
- X509CertificateLoader.cs
- Origem:
- X509CertificateLoader.cs
- Origem:
- X509CertificateLoader.cs
Abre o ficheiro especificado, lê o conteúdo como um PFX PKCS#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 ficheiro para abrir.
- password
- String
A palavra-passe para desencriptar 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 devolvido.
- loaderLimits
- Pkcs12LoaderLimits
Limites a aplicar ao carregar o PFX. Um null valor, o padrão, é equivalente a Defaults.
Devoluções
O certificado carregado.
Exceções
path é null.
keyStorageFlags contém um valor, ou combinação de valores, que não é válida.
keyStorageFlags contém um valor que não é válido para a plataforma atual.
O PKCS#12/PFX violava uma ou mais restrições de loaderLimits.
Ocorreu um erro durante o carregamento do PKCS#12/PFX.
Ocorreu um erro durante o carregamento do ficheiro especificado.
Observações
Um PKCS#12/PFX pode conter múltiplos certificados. Usando a ordem em que os certificados aparecem nos resultados de LoadPkcs12CollectionFromFile(String, String, X509KeyStorageFlags, Pkcs12LoaderLimits), este método devolve o primeiro certificado onde HasPrivateKey é true. Se nenhum certificado tiver chaves privadas associadas, então o primeiro certificado é devolvido. Se o PKCS#12/PFX não contiver certificados, a CryptographicException é lançado.
