X509Certificate Classe

Definição

Namespace:
System.Security.Cryptography.X509Certificates
Assemblies:
netstandard.dll, System.Security.Cryptography.dll
Assemblies:
netstandard.dll, System.Security.Cryptography.X509Certificates.dll
Assemblies:
netstandard.dll, System.Security.Cryptography.dll, System.Security.Cryptography.X509Certificates.dll
Assembly:
System.Security.Cryptography.X509Certificates.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Origem:
X509Certificate.cs
Origem:
X509Certificate.cs
Origem:
X509Certificate.cs
Origem:
X509Certificate.cs
Origem:
X509Certificate.cs

Fornece métodos que ajudam você 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 a seguir carrega um certificado X.509 de um arquivo, chama o ToString método e exibe os resultados para o console.

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

Comentários

O ASN.1 DER é o único formato de certificado compatível com essa classe.

Para a maioria dos cenários, você deve usar a X509Certificate2 classe em vez disso.

Importante

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

Para aplicativos direcionados ao .NET Framework 4.5.2 e versões anteriores, a X509Certificate classe não implementa a IDisposable interface e, portanto, não tem um Dispose método.

Construtores

Nome Description
X509Certificate()
Obsoleto.
Obsoleto.

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

Inicializa uma nova instância da X509Certificate classe usando uma matriz de bytes, uma senha e um sinalizador de armazenamento de chaves.
X509Certificate(Byte[], SecureString)
Obsoleto.

Inicializa uma nova instância da X509Certificate classe usando uma matriz de bytes e uma senha.
X509Certificate(Byte[], String, X509KeyStorageFlags)
Obsoleto.

Inicializa uma nova instância da X509Certificate classe usando uma matriz de bytes, uma senha e um sinalizador de armazenamento de chaves.
X509Certificate(Byte[], String)
Obsoleto.

Inicializa uma nova instância da X509Certificate classe usando uma matriz de bytes e uma senha.
X509Certificate(Byte[])
Obsoleto.

Inicializa uma nova instância da classe definida a X509Certificate 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 identificador para uma estrutura não gerenciada 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 arquivo de certificado, uma senha e um sinalizador de armazenamento de chaves.
X509Certificate(String, SecureString)
Obsoleto.

Inicializa uma nova instância da X509Certificate classe usando um nome de arquivo de certificado e uma senha.
X509Certificate(String, String, X509KeyStorageFlags)
Obsoleto.

Inicializa uma nova instância da X509Certificate classe usando o nome de um arquivo assinado PKCS7, uma senha para acessar o certificado e um sinalizador de armazenamento de chaves.
X509Certificate(String, String)
Obsoleto.

Inicializa uma nova instância da X509Certificate classe usando o nome de um arquivo assinado PKCS7 e uma senha para acessar o certificado.
X509Certificate(String)
Obsoleto.

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

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

Propriedades

Nome Description
Handle

Obtém um identificador para um contexto de certificado da API Criptográfica da Microsoft descrito por uma estrutura não gerenciada PCCERT_CONTEXT .
Issuer

Obtém o nome da autoridade de certificação 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 diferenciado da entidade do certificado.

Métodos

Nome Description
CreateFromCertFile(String)
Obsoleto.

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

Cria um certificado X.509v3 do arquivo assinado especificado.
Dispose()

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

Libera todos os recursos não gerenciados usados por isso X509Certificate e, opcionalmente, libera os recursos gerenciados.
Equals(Object)

Compara dois objetos X509Certificate quanto à igualdade.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
Equals(X509Certificate)

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

Exporta o objeto atual X509Certificate para uma matriz de bytes usando o formato especificado e uma senha.
Export(X509ContentType, String)

Exporta o objeto atual X509Certificate para uma matriz de bytes em um formato descrito por um dos X509ContentType valores e usando a senha especificada.
Export(X509ContentType)

Exporta o objeto atual X509Certificate para uma matriz de bytes em um 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 a hora especificadas em uma cadeia de caracteres.
GetCertHash()

Retorna o valor de hash para o certificado X.509v3 como uma matriz de bytes.
GetCertHash(HashAlgorithmName)

Retorna o valor de hash do certificado X.509v3 computado usando o algoritmo de hash criptográfico especificado.
GetCertHashString()

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

Retorna uma cadeia de caracteres hexadecimal que contém o valor de hash para o certificado X.509v3 calculado usando o algoritmo de hash criptográfico especificado.
GetEffectiveDateString()

Retorna a data efetiva deste certificado X.509v3.
GetExpirationDateString()

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

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

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

Retorna o nome da autoridade de certificação que emitiu o certificado X.509v3.
GetKeyAlgorithm()

Retorna as informações de algoritmo de chave para esse certificado X.509v3 como uma cadeia de caracteres.
GetKeyAlgorithmParameters()

Retorna os parâmetros de algoritmo de chave para o certificado X.509v3 como uma matriz de bytes.
GetKeyAlgorithmParametersString()

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

Retorna o nome da entidade de segurança para a qual o certificado foi emitido.
GetPublicKey()

Retorna a chave pública para o certificado X.509v3 como uma matriz de bytes.
GetPublicKeyString()

Retorna a chave pública para o certificado X.509v3 como uma cadeia de caracteres hexadecimal.
GetRawCertData()

Retorna os dados brutos de todo o certificado X.509v3 como uma matriz de bytes.
GetRawCertDataString()

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

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

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

Obtém o Type da instância atual.

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

Popula um X509Certificate objeto usando dados de uma matriz de bytes, uma senha e um sinalizador de armazenamento de chaves.
Import(Byte[], String, X509KeyStorageFlags)
Obsoleto.
Obsoleto.

Popula o X509Certificate objeto usando dados de uma matriz de bytes, uma senha e sinalizadores para determinar como a chave privada é importada.
Import(Byte[])
Obsoleto.
Obsoleto.

Popula o X509Certificate objeto com dados de uma matriz de bytes.
Import(String, SecureString, X509KeyStorageFlags)
Obsoleto.
Obsoleto.

Popula um X509Certificate objeto com informações de um arquivo de certificado, uma senha e um sinalizador de armazenamento de chaves.
Import(String, String, X509KeyStorageFlags)
Obsoleto.
Obsoleto.

Popula o X509Certificate objeto com informações de um arquivo de certificado, uma senha e um X509KeyStorageFlags valor.
Import(String)
Obsoleto.
Obsoleto.

Popula o X509Certificate objeto com informações de um arquivo de certificado.
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
Reset()

Redefine o estado do X509Certificate2 objeto.
ToString()

Retorna uma representação de cadeia de caracteres do objeto atual X509Certificate .
ToString(Boolean)

Retorna uma representação de cadeia de caracteres do objeto atual X509Certificate , com informações extras, se especificado.
TryGetCertHash(HashAlgorithmName, Span<Byte>, Int32)

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

Implantações explícitas de interface

Nome Description
IDeserializationCallback.OnDeserialization(Object)

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

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

Aplica-se a