X509Certificate Classe

Definição

Espaço de Nomes:
System.Security.Cryptography.X509Certificates
Assemblagens:
netstandard.dll, System.Security.Cryptography.dll
Assemblagens:
netstandard.dll, System.Security.Cryptography.X509Certificates.dll
Assemblagens:
netstandard.dll, System.Security.Cryptography.dll, System.Security.Cryptography.X509Certificates.dll
Assemblagem:
System.Security.Cryptography.X509Certificates.dll
Assemblagem:
mscorlib.dll
Assemblagem:
netstandard.dll
Origem:
X509Certificate.cs
Origem:
X509Certificate.cs
Origem:
X509Certificate.cs
Origem:
X509Certificate.cs
Origem:
X509Certificate.cs

Fornece métodos que ajudam a usar certificados X.509 v.3.

public ref class X509Certificate : IDisposable, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable
public ref class X509Certificate : IDisposable
public ref class X509Certificate
public ref class X509Certificate : System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable
public class X509Certificate : IDisposable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable
public class X509Certificate : IDisposable
[System.Serializable]
public class X509Certificate
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class X509Certificate : System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class X509Certificate : IDisposable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable
type X509Certificate = class
    interface IDisposable
    interface IDeserializationCallback
    interface ISerializable
type X509Certificate = class
    interface IDisposable
type X509Certificate = class
    interface IDisposable
    interface ISerializable
    interface IDeserializationCallback
[<System.Serializable>]
type X509Certificate = class
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type X509Certificate = class
    interface IDeserializationCallback
    interface ISerializable
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type X509Certificate = class
    interface IDisposable
    interface IDeserializationCallback
    interface ISerializable
Public Class X509Certificate
Implements IDeserializationCallback, IDisposable, ISerializable
Public Class X509Certificate
Implements IDisposable
Public Class X509Certificate
Public Class X509Certificate
Implements IDeserializationCallback, ISerializable
Herança
Object
X509Certificate
Derivado
Atributos
SerializableAttribute ComVisibleAttribute
Implementações
IDisposable IDeserializationCallback ISerializable

Exemplos

O exemplo seguinte carrega um certificado X.509 a partir de um ficheiro, chama o ToString método e apresenta os resultados na consola.

using System;
using System.Security.Cryptography.X509Certificates;

public class X509
{

    public static void Main()
    {

        // The path to the certificate.
        string Certificate = "Certificate.cer";

        // Load the certificate into an X509Certificate object.
        X509Certificate cert = new X509Certificate(Certificate);

        // Get the value.
        string resultsTrue = cert.ToString(true);

        // Display the value to the console.
        Console.WriteLine(resultsTrue);

        // Get the value.
        string resultsFalse = cert.ToString(false);

        // Display the value to the console.
        Console.WriteLine(resultsFalse);
    }
}

Imports System.Security.Cryptography.X509Certificates

Module X509

    Sub Main()

        ' The path to the certificate.
        Dim Certificate As String = "Certificate.cer"

        ' Load the certificate into an X509Certificate object.
        Dim cert As New X509Certificate(Certificate)

        ' Get the value.
        Dim resultsTrue As String = cert.ToString(True)

        ' Display the value to the console.
        Console.WriteLine(resultsTrue)

        ' Get the value.
        Dim resultsFalse As String = cert.ToString(False)

        ' Display the value to the console.
        Console.WriteLine(resultsFalse)

    End Sub
End Module

Observações

ASN.1 DER é o único formato de certificado suportado por esta classe.

Para a maioria dos cenários, deves usar a X509Certificate2 classe em vez disso.

Importante

A partir do .NET Framework 4.6, este tipo implementa a interface IDisposable. Quando terminar de usar o tipo, você deve eliminá-lo direta ou indiretamente. Para descartar o tipo diretamente, chame seu método Dispose em um bloco try/catch. Para descartá-lo indiretamente, use uma construção de linguagem como using (em C#) ou Using (em Visual Basic). Para obter mais informações, consulte a seção "Usando um objeto que implementa IDisposable" no tópico da IDisposable interface.

Para aplicações que visam o .NET Framework 4.5.2 e versões anteriores, a classe X509Certificate não implementa a interface IDisposable e, por isso, não possui um método Dispose.

Construtores

Name Description
X509Certificate()
Obsoleto.
Obsoleto.

Inicializa uma nova instância da X509Certificate classe.
X509Certificate(Byte[], SecureString, X509KeyStorageFlags)
Obsoleto.

Inicializa uma nova instância da X509Certificate classe usando um array de bytes, uma palavra-passe e um flag de armazenamento de chaves.
X509Certificate(Byte[], SecureString)
Obsoleto.

Inicializa uma nova instância da X509Certificate classe usando um array de bytes e uma palavra-passe.
X509Certificate(Byte[], String, X509KeyStorageFlags)
Obsoleto.

Inicializa uma nova instância da X509Certificate classe usando um array de bytes, uma palavra-passe e um flag de armazenamento de chaves.
X509Certificate(Byte[], String)
Obsoleto.

Inicializa uma nova instância da X509Certificate classe usando um array de bytes e uma palavra-passe.
X509Certificate(Byte[])
Obsoleto.

Inicializa uma nova instância da X509Certificate classe definida a partir de uma sequência de bytes que representa um certificado X.509v3.
X509Certificate(IntPtr)

Inicializa uma nova instância da X509Certificate classe usando um handle numa estrutura não gerida PCCERT_CONTEXT .
X509Certificate(SerializationInfo, StreamingContext)
Obsoleto.

Inicializa uma nova instância da X509Certificate classe usando um SerializationInfo objeto e uma StreamingContext estrutura.
X509Certificate(String, SecureString, X509KeyStorageFlags)
Obsoleto.

Inicializa uma nova instância da X509Certificate classe usando um nome de ficheiro de certificado, uma palavra-passe e um flag de armazenamento de chaves.
X509Certificate(String, SecureString)
Obsoleto.

Inicializa uma nova instância da X509Certificate classe usando um nome de ficheiro de certificado e uma palavra-passe.
X509Certificate(String, String, X509KeyStorageFlags)
Obsoleto.

Inicializa uma nova instância da X509Certificate classe usando o nome de um ficheiro assinado por PKCS7, uma palavra-passe para aceder ao certificado e um flag de armazenamento de chaves.
X509Certificate(String, String)
Obsoleto.

Inicializa uma nova instância da X509Certificate classe usando o nome de um ficheiro assinado por PKCS7 e uma palavra-passe para aceder ao certificado.
X509Certificate(String)
Obsoleto.

Inicializa uma nova instância da X509Certificate classe usando o nome de um ficheiro assinado por PKCS7.
X509Certificate(X509Certificate)

Inicializa uma nova instância da X509Certificate classe usando outra X509Certificate classe.

Propriedades

Name Description
Handle

Obtém um acesso a um Microsoft contexto de certificado API criptográfico descrito por uma estrutura PCCERT_CONTEXT não gerida.
Issuer

Obtém o nome da autoridade certificadora que emitiu o certificado X.509v3.
SerialNumberBytes

Obtém a representação big-endian do número de série do certificado.
Subject

Obtém o nome distinto do sujeito no certificado.

Métodos

Name Description
CreateFromCertFile(String)
Obsoleto.

Cria um certificado X.509v3 a partir do ficheiro assinado PKCS7 especificado.
CreateFromSignedFile(String)
Obsoleto.

Cria um certificado X.509v3 a partir do ficheiro assinado especificado.
Dispose()

Liberta todos os recursos usados pelo objeto atual X509Certificate .
Dispose(Boolean)

Liberta todos os recursos não geridos usados por isto X509Certificate e, opcionalmente, liberta os recursos geridos.
Equals(Object)

Compara dois X509Certificate objetos para igualdade.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
Equals(X509Certificate)

Compara dois X509Certificate objetos para igualdade.
Export(X509ContentType, SecureString)

Exporta o objeto atual X509Certificate para um array de bytes usando o formato especificado e uma palavra-passe.
Export(X509ContentType, String)

Exporta o objeto atual X509Certificate para um array de bytes num formato descrito por um dos X509ContentType valores, usando a palavra-passe especificada.
Export(X509ContentType)

Exporta o objeto atual X509Certificate para um array de bytes num formato descrito por um dos X509ContentType valores.
ExportPkcs12(PbeParameters, String)

Exporta o certificado e a chave privada no formato PKCS#12 / PFX.
ExportPkcs12(Pkcs12ExportPbeParameters, String)

Exporta o certificado e a chave privada no formato PKCS#12 / PFX.
FormatDate(DateTime)

Converte a data e hora especificadas numa cadeia.
GetCertHash()

Devolve o valor de hash do certificado X.509v3 como um array de bytes.
GetCertHash(HashAlgorithmName)

Devolve o valor de hash para o certificado X.509v3 que é calculado usando o algoritmo de hash criptográfico especificado.
GetCertHashString()

Devolve o valor de hash SHA-1 para o certificado X.509v3 como uma cadeia hexadecimal.
GetCertHashString(HashAlgorithmName)

Devolve uma cadeia hexadecimal contendo o valor de hash do certificado X.509v3 calculado usando o algoritmo de hash criptográfico especificado.
GetEffectiveDateString()

Devolve a data de entrada em vigor deste certificado X.509v3.
GetExpirationDateString()

Devolve a data de validade deste certificado X.509v3.
GetFormat()

Devolve o nome do formato deste certificado X.509v3.
GetHashCode()

Devolve o código de hash do certificado X.509v3 como um inteiro.
GetIssuerName()
Obsoleto.
Obsoleto.
Obsoleto.

Devolve o nome da autoridade certificadora que emitiu o certificado X.509v3.
GetKeyAlgorithm()

Devolve a informação chave do algoritmo para este certificado X.509v3 como uma cadeia.
GetKeyAlgorithmParameters()

Devolve os parâmetros chave do algoritmo para o certificado X.509v3 como um array de bytes.
GetKeyAlgorithmParametersString()

Devolve os parâmetros chave do algoritmo para o certificado X.509v3 como uma cadeia hexadecimal.
GetName()
Obsoleto.
Obsoleto.
Obsoleto.

Devolve o nome do principal a quem o certificado foi emitido.
GetPublicKey()

Devolve a chave pública do certificado X.509v3 como um array de bytes.
GetPublicKeyString()

Devolve a chave pública do certificado X.509v3 como uma cadeia hexadecimal.
GetRawCertData()

Devolve os dados brutos de todo o certificado X.509v3 como um array de bytes.
GetRawCertDataString()

Devolve os dados brutos de todo o certificado X.509v3 como uma cadeia hexadecimal.
GetSerialNumber()

Devolve o número de série do certificado X.509v3 como um array de bytes em ordem little-endian.
GetSerialNumberString()

Devolve o número de série do certificado X.509v3 como uma cadeia hexadecimal big-endian.
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
Import(Byte[], SecureString, X509KeyStorageFlags)
Obsoleto.
Obsoleto.

Preenche um X509Certificate objeto usando dados de um array de bytes, uma palavra-passe e uma flag de armazenamento de chaves.
Import(Byte[], String, X509KeyStorageFlags)
Obsoleto.
Obsoleto.

Preenche o X509Certificate objeto usando dados de um array de bytes, uma palavra-passe e flags para determinar como a chave privada é importada.
Import(Byte[])
Obsoleto.
Obsoleto.

Preenche o X509Certificate objeto com dados de um array de bytes.
Import(String, SecureString, X509KeyStorageFlags)
Obsoleto.
Obsoleto.

Preenche um X509Certificate objeto com informações de um ficheiro de certificado, uma palavra-passe e um flag de armazenamento de chaves.
Import(String, String, X509KeyStorageFlags)
Obsoleto.
Obsoleto.

Preenche o X509Certificate objeto com informações de um ficheiro de certificado, uma palavra-passe e um X509KeyStorageFlags valor.
Import(String)
Obsoleto.
Obsoleto.

Preenche o X509Certificate objeto com informação de um ficheiro de certificado.
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
Reset()

Reinicia o estado do X509Certificate2 objeto.
ToString()

Devolve uma representação em cadeia do objeto atual X509Certificate .
ToString(Boolean)

Devolve uma representação em cadeia do objeto atual X509Certificate , com informação adicional, se especificado.
TryGetCertHash(HashAlgorithmName, Span<Byte>, Int32)

Tenta produzir uma "impressão digital" para o certificado através do hash da representação codificada do certificado com o algoritmo de hash especificado.

Implementações de Interface Explícita

Name Description
IDeserializationCallback.OnDeserialization(Object)

Implementa a ISerializable interface e é chamada de volta pelo evento de desserialização quando a desserialização está concluída.
ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Obtém informação de serialização com todos os dados necessários para recriar uma instância do objeto atual X509Certificate .

Aplica-se a