X509Certificate Classe

Definição

Namespace:

System.Security.Cryptography.X509Certificates

Assembly:

System.Security.Cryptography.dll

Origem:

X509Certificate.cs

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

public ref class X509Certificate : IDisposable, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable

public class X509Certificate : IDisposable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable

type X509Certificate = class
    interface IDisposable
    interface IDeserializationCallback
    interface ISerializable

Public Class X509Certificate
Implements IDeserializationCallback, IDisposable, ISerializable

Herança

Object

X509Certificate

Derivado

System.Security.Cryptography.X509Certificates.X509Certificate2

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 namespace System;
using namespace System::Security::Cryptography::X509Certificates;
int main()
{
   
   // The path to the certificate.
   String^ Certificate = L"Certificate.cer";
   
   // Load the certificate into an X509Certificate object.
   X509Certificate^ cert = gcnew 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 );
}

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 .

Importante

A partir do .NET Framework 4.6, esse tipo implementa a IDisposable interface . Quando você terminar de usar o tipo, deverá descartá-lo direta ou indiretamente. 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 (em Visual Basic). Saiba mais na seção "Como usar um objeto que implementa IDisposable" no tópico da interface IDisposable.

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

X509Certificate()	Obsoleto. Inicializa uma nova instância da classe X509Certificate.
X509Certificate(Byte[])	Inicializa uma nova instância da classe X509Certificate definida de uma sequência de bytes que representa um certificado X.509v3.
X509Certificate(Byte[], SecureString)	Inicializa uma nova instância da classe X509Certificate usando uma matriz de bytes e uma senha.
X509Certificate(Byte[], SecureString, X509KeyStorageFlags)	Inicializa uma nova instância da classe X509Certificate usando uma matriz de bytes, uma senha e um sinalizador de armazenamento de chaves.
X509Certificate(Byte[], String)	Inicializa uma nova instância da classe X509Certificate usando uma matriz de bytes e uma senha.
X509Certificate(Byte[], String, X509KeyStorageFlags)	Inicializa uma nova instância da classe X509Certificate usando uma matriz de bytes, uma senha e um sinalizador de armazenamento de chaves.
X509Certificate(IntPtr)	Inicializa uma nova instância da classe X509Certificate usando um identificador para uma estrutura PCCERT_CONTEXT não gerenciada.
X509Certificate(SerializationInfo, StreamingContext)	Obsoleto. Inicializa uma nova instância da classe X509Certificate usando um objeto SerializationInfo e uma estrutura StreamingContext.
X509Certificate(String)	Inicializa uma nova instância da classe X509Certificate usando o nome de um arquivo assinado PKCS7.
X509Certificate(String, SecureString)	Inicializa uma nova instância da classe X509Certificate usando um nome de arquivo de certificado e uma senha.
X509Certificate(String, SecureString, X509KeyStorageFlags)	Inicializa uma nova instância da classe X509Certificate usando um nome de arquivo de certificado, uma senha e um sinalizador de armazenamento de chaves.
X509Certificate(String, String)	Inicializa uma nova instância da classe X509Certificate usando o nome de um arquivo assinado por PKCS7 e uma senha para acessar o certificado.
X509Certificate(String, String, X509KeyStorageFlags)	Inicializa uma nova instância da classe X509Certificate usando o nome de um arquivo com sinal PKCS7, uma senha para acessar o certificado e um sinalizador de armazenamento de chaves.
X509Certificate(X509Certificate)	Inicializa uma nova instância da classe X509Certificate usando outra classe X509Certificate.

Propriedades

Handle	Obtém um identificador para um contexto de certificado da API Criptográfica da Microsoft descrito por uma estrutura PCCERT_CONTEXT não gerenciada.
Issuer	Obtém o nome da autoridade de certificado 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

CreateFromCertFile(String)	Cria um certificado X.509v3 com base no arquivo assinado PKCS7 especificado.
CreateFromSignedFile(String)	Cria um certificado X.509v3 do arquivo assinado especificado.
Dispose()	Libera todos os recursos usados pelo objeto X509Certificate atual.
Dispose(Boolean)	Libera todos os recursos não gerenciados usados por este X509Certificate e, opcionalmente, libera os recursos gerenciados.
Equals(Object)	Compara dois objetos X509Certificate quanto à igualdade.
Equals(X509Certificate)	Compara dois objetos X509Certificate quanto à igualdade.
Export(X509ContentType)	Exporta o objeto X509Certificate atual para uma matriz de bytes em um formato descrito por um dos valores de X509ContentType.
Export(X509ContentType, SecureString)	Exporta o objeto X509Certificate atual para uma matriz de bytes usando o formato especificado e uma senha.
Export(X509ContentType, String)	Exporta o objeto X509Certificate atual para uma matriz de bytes em um formato descrito por um dos valores X509ContentType e com a senha especificada.
FormatDate(DateTime)	Converte a data e hora especificadas em uma cadeia de caracteres.
GetCertHash()	Retorna o valor do hash para o certificado x.509v3 como uma matriz de bytes.
GetCertHash(HashAlgorithmName)	Retorna o valor de hash do certificado X.509v3 que é calculado usando o algoritmo de hash criptográfico especificado.
GetCertHashString()	Retorna o valor de hash SHA1 do certificado X.509v3 como uma cadeia de caracteres hexadecimal.
GetCertHashString(HashAlgorithmName)	Retorna uma cadeia de caracteres hexadecimal que contém o valor de hash do certificado X.509v3 calculado usando algoritmo de hash criptográfico especificado.
GetEffectiveDateString()	Retorna a data de efetivação deste certificado X.509v3.
GetExpirationDateString()	Retorna a data de validade deste certificado X.509v3.
GetFormat()	Retorna o nome do formato desse certificado X.509v3.
GetHashCode()	Retorna o código hash do certificado X.509v3 como um inteiro.
GetIssuerName()	Obsoleto. Retorna o nome da autoridade de certificação que emitiu o certificado X.509v3.
GetKeyAlgorithm()	Retorna as informações de algoritmo de chave do certificado X.509v3 como uma cadeia de caracteres.
GetKeyAlgorithmParameters()	Retorna os parâmetros de algoritmo de chave do certificado X.509v3 como uma matriz de bytes.
GetKeyAlgorithmParametersString()	Retorna os parâmetros de algoritmo de chave do certificado X.509v3 como uma cadeia de caracteres hexadecimal.
GetName()	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 do 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 do 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 little endian.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
Import(Byte[])	Obsoleto. Preenche o objeto X509Certificate com os dados de uma matriz de bytes.
Import(Byte[], SecureString, X509KeyStorageFlags)	Obsoleto. Popula um objeto X509Certificate usando dados de uma matriz de bytes, uma senha e um sinalizador de armazenamento de chaves.
Import(Byte[], String, X509KeyStorageFlags)	Obsoleto. Popula o objeto X509Certificate usando dados de uma matriz de bytes, uma senha e sinalizadores para determinar como a chave privada é importada.
Import(String)	Obsoleto. Popula o objeto X509Certificate com informações de um arquivo de certificado.
Import(String, SecureString, X509KeyStorageFlags)	Obsoleto. Popula um objeto X509Certificate com informações de um arquivo de certificado, uma senha e um sinalizador de armazenamento de chaves.
Import(String, String, X509KeyStorageFlags)	Obsoleto. Popula o objeto X509Certificate com informações de um arquivo de certificado, uma senha e um valor X509KeyStorageFlags.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
Reset()	Redefine o estado do objeto X509Certificate2.
ToString()	Retorna uma representação de cadeia de caracteres do objeto X509Certificate atual.
ToString(Boolean)	Retorna uma representação de cadeia de caracteres do objeto X509Certificate atual, com informações adicionais, se especificadas.
TryGetCertHash(HashAlgorithmName, Span<Byte>, Int32)	Tenta produzir uma "impressão digital" para o certificado por meio do hash da representação codificada do certificado com o algoritmo de hash especificado.

Implantações explícitas de interface

IDeserializationCallback.OnDeserialization(Object)	Implementa a interface ISerializable e é chamado 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 X509Certificate atual.