X509Certificate Classe

Definição

Fornece métodos que o ajudam a usar certificados X.509 v.3.Provides methods that help you use X.509 v.3 certificates.

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

Exemplos

O exemplo a seguir carrega um certificado X. 509 de um arquivo, chama o método ToString e exibe os resultados para o console.The following example loads an X.509 certificate from a file, calls the ToString method, and displays the results to the 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

ASN. 1 DER é o único formato de certificado com suporte nesta classe.ASN.1 DER is the only certificate format supported by this class.

Para a maioria dos cenários, você deve usar a classe X509Certificate2 em vez disso.For most scenarios, you should use the X509Certificate2 class instead.

Importante

A partir do .NET Framework 4.6.NET Framework 4.6, esse tipo implementa a interface IDisposable.Starting with the .NET Framework 4.6.NET Framework 4.6, this type implements the IDisposable interface. Quando você terminar de usar o tipo, deverá descartá-lo direta ou indiretamente.When you have finished using the type, you should dispose of it either directly or indirectly. Para descartar o tipo diretamente, chame o método Dispose dele em um bloco try/catch.To dispose of the type directly, call its Dispose method in a try/catch block. Para descartá-lo indiretamente, use um constructo de linguagem como using ( em C#) ou Using (em Visual Basic).To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). Saiba mais na seção "Como usar um objeto que implementa IDisposable" no tópico da interface IDisposable.For more information, see the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

Para aplicativos direcionados para o .NET Framework 4.5.2.NET Framework 4.5.2 e versões anteriores, a classe X509Certificate não implementa a interface IDisposable e, portanto, não tem um método Dispose.For apps that target the .NET Framework 4.5.2.NET Framework 4.5.2 and earlier versions, the X509Certificate class does not implement the IDisposable interface and therefore does not have a Dispose method.

Construtores

X509Certificate()

Inicializa uma nova instância da classe X509Certificate.Initializes a new instance of the X509Certificate class.

X509Certificate(Byte[])

Inicializa uma nova instância da classe X509Certificate definida de uma sequência de bytes que representa um certificado X.509v3.Initializes a new instance of the X509Certificate class defined from a sequence of bytes representing an X.509v3 certificate.

X509Certificate(Byte[], SecureString)

Inicializa uma nova instância da classe X509Certificate usando uma matriz de bytes e uma senha.Initializes a new instance of the X509Certificate class using a byte array and a password.

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.Initializes a new instance of the X509Certificate class using a byte array, a password, and a key storage flag.

X509Certificate(Byte[], String)

Inicializa uma nova instância da classe X509Certificate usando uma matriz de bytes e uma senha.Initializes a new instance of the X509Certificate class using a byte array and a password.

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.Initializes a new instance of the X509Certificate class using a byte array, a password, and a key storage flag.

X509Certificate(IntPtr)

Inicializa uma nova instância da classe X509Certificate usando um identificador para uma estrutura PCCERT_CONTEXT não gerenciada.Initializes a new instance of the X509Certificate class using a handle to an unmanaged PCCERT_CONTEXT structure.

X509Certificate(SerializationInfo, StreamingContext)

Inicializa uma nova instância da classe X509Certificate usando um objeto SerializationInfo e uma estrutura StreamingContext.Initializes a new instance of the X509Certificate class using a SerializationInfo object and a StreamingContext structure.

X509Certificate(String)

Inicializa uma nova instância da classe X509Certificate usando o nome de um arquivo assinado PKCS7.Initializes a new instance of the X509Certificate class using the name of a PKCS7 signed file.

X509Certificate(String, SecureString)

Inicializa uma nova instância da classe X509Certificate usando um nome de arquivo de certificado e uma senha.Initializes a new instance of the X509Certificate class using a certificate file name and a password.

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.Initializes a new instance of the X509Certificate class using a certificate file name, a password, and a key storage flag.

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.Initializes a new instance of the X509Certificate class using the name of a PKCS7 signed file and a password to access the certificate.

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.Initializes a new instance of the X509Certificate class using the name of a PKCS7 signed file, a password to access the certificate, and a key storage flag.

X509Certificate(X509Certificate)

Inicializa uma nova instância da classe X509Certificate usando outra classe X509Certificate.Initializes a new instance of the X509Certificate class using another X509Certificate class.

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.Gets a handle to a Microsoft Cryptographic API certificate context described by an unmanaged PCCERT_CONTEXT structure.

Issuer

Obtém o nome da autoridade de certificado que emitiu o certificado X.509v3.Gets the name of the certificate authority that issued the X.509v3 certificate.

Subject

Obtém o nome diferenciado da entidade do certificado.Gets the subject distinguished name from the certificate.

Métodos

CreateFromCertFile(String)

Cria um certificado X.509v3 com base no arquivo assinado PKCS7 especificado.Creates an X.509v3 certificate from the specified PKCS7 signed file.

CreateFromSignedFile(String)

Cria um certificado X.509v3 do arquivo assinado especificado.Creates an X.509v3 certificate from the specified signed file.

Dispose()

Libera todos os recursos usados pelo objeto X509Certificate atual.Releases all resources used by the current X509Certificate object.

Dispose(Boolean)

Libera todos os recursos não gerenciados usados por este X509Certificate e, opcionalmente, libera os recursos gerenciados.Releases all of the unmanaged resources used by this X509Certificate and optionally releases the managed resources.

Equals(Object)

Compara dois objetos X509Certificate quanto à igualdade.Compares two X509Certificate objects for equality.

Equals(X509Certificate)

Compara dois objetos X509Certificate quanto à igualdade.Compares two X509Certificate objects for equality.

Export(X509ContentType)

Exporta o objeto X509Certificate atual para uma matriz de bytes em um formato descrito por um dos valores de X509ContentType.Exports the current X509Certificate object to a byte array in a format described by one of the X509ContentType values.

Export(X509ContentType, SecureString)

Exporta o objeto X509Certificate atual para uma matriz de bytes usando o formato especificado e uma senha.Exports the current X509Certificate object to a byte array using the specified format and a password.

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.Exports the current X509Certificate object to a byte array in a format described by one of the X509ContentType values, and using the specified password.

FormatDate(DateTime)

Converte a data e hora especificadas em uma cadeia de caracteres.Converts the specified date and time to a string.

GetCertHash()

Retorna o valor do hash para o certificado x.509v3 como uma matriz de bytes.Returns the hash value for the X.509v3 certificate as an array of bytes.

GetCertHash(HashAlgorithmName)

Retorna o valor de hash do certificado X.509v3 que é calculado usando o algoritmo de hash criptográfico especificado.Returns the hash value for the X.509v3 certificate that is computed by using the specified cryptographic hash algorithm.

GetCertHashString()

Retorna o valor de hash SHA1 para o certificado X.509 v3 como uma cadeia de caracteres hexadecimal.Returns the SHA1 hash value for the X.509v3 certificate as a hexadecimal string.

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.Returns a hexadecimal string containing the hash value for the X.509v3 certificate computed using the specified cryptographic hash algorithm.

GetEffectiveDateString()

Retorna a data de efetivação deste certificado X.509v3.Returns the effective date of this X.509v3 certificate.

GetExpirationDateString()

Retorna a data de validade deste certificado X.509v3.Returns the expiration date of this X.509v3 certificate.

GetFormat()

Retorna o nome do formato deste certificado X.509v3.Returns the name of the format of this X.509v3 certificate.

GetHashCode()

Retorna o código hash do certificado X.509v3 como um inteiro.Returns the hash code for the X.509v3 certificate as an integer.

GetIssuerName()

Retorna o nome da autoridade de certificação que emitiu o certificado X.509v3.Returns the name of the certification authority that issued the X.509v3 certificate.

GetKeyAlgorithm()

Retorna as informações de algoritmo de chave desse certificado X.509v3 como uma cadeia de caracteres.Returns the key algorithm information for this X.509v3 certificate as a string.

GetKeyAlgorithmParameters()

Retorna os parâmetros de algoritmo de chave do certificado X.509v3 como uma matriz de bytes.Returns the key algorithm parameters for the X.509v3 certificate as an array of bytes.

GetKeyAlgorithmParametersString()

Retorna os parâmetros do algoritmo de chave do certificado X.509v3 como uma cadeia de caracteres hexadecimal.Returns the key algorithm parameters for the X.509v3 certificate as a hexadecimal string.

GetName()

Retorna o nome da entidade de segurança para a qual o certificado foi emitido.Returns the name of the principal to which the certificate was issued.

GetPublicKey()

Retorna a chave pública para o certificado x.509v3 como uma matriz de bytes.Returns the public key for the X.509v3 certificate as an array of bytes.

GetPublicKeyString()

Retorna a chave pública do certificado X.509v3 como uma cadeia de caracteres hexadecimal.Returns the public key for the X.509v3 certificate as a hexadecimal string.

GetRawCertData()

Retorna os dados brutos de todo o certificado X.509v3 como uma matriz de bytes.Returns the raw data for the entire X.509v3 certificate as an array of bytes.

GetRawCertDataString()

Retorna os dados brutos do certificado X.509v3 como uma cadeia de caracteres hexadecimal.Returns the raw data for the entire X.509v3 certificate as a hexadecimal string.

GetSerialNumber()

Retorna o número de série do certificado X.509v3 como uma matriz de bytes em ordem little endian.Returns the serial number of the X.509v3 certificate as an array of bytes in little-endian order.

GetSerialNumberString()

Retorna o número de série do certificado X.509v3 como uma cadeia de caracteres hexadecimal little endian.Returns the serial number of the X.509v3 certificate as a little-endian hexadecimal string .

GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
Import(Byte[])

Preenche o objeto X509Certificate com os dados de uma matriz de bytes.Populates the X509Certificate object with data from a byte array.

Import(Byte[], SecureString, X509KeyStorageFlags)

Popula um objeto X509Certificate usando dados de uma matriz de bytes, uma senha e um sinalizador de armazenamento de chaves.Populates an X509Certificate object using data from a byte array, a password, and a key storage flag.

Import(Byte[], String, X509KeyStorageFlags)

Popula o objeto X509Certificate usando dados de uma matriz de bytes, uma senha e sinalizadores para determinar como a chave privada é importada.Populates the X509Certificate object using data from a byte array, a password, and flags for determining how the private key is imported.

Import(String)

Popula o objeto X509Certificate com informações de um arquivo de certificado.Populates the X509Certificate object with information from a certificate file.

Import(String, SecureString, X509KeyStorageFlags)

Popula um objeto X509Certificate com informações de um arquivo de certificado, uma senha e um sinalizador de armazenamento de chaves.Populates an X509Certificate object with information from a certificate file, a password, and a key storage flag.

Import(String, String, X509KeyStorageFlags)

Popula o objeto X509Certificate com informações de um arquivo de certificado, uma senha e um valor X509KeyStorageFlags.Populates the X509Certificate object with information from a certificate file, a password, and a X509KeyStorageFlags value.

MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
Reset()

Redefine o estado do objeto X509Certificate2.Resets the state of the X509Certificate2 object.

ToString()

Retorna uma representação de cadeia de caracteres do objeto X509Certificate atual.Returns a string representation of the current X509Certificate object.

ToString(Boolean)

Retorna uma representação de cadeia de caracteres do objeto X509Certificate atual, com informações adicionais, se especificadas.Returns a string representation of the current X509Certificate object, with extra information, if specified.

TryGetCertHash(HashAlgorithmName, Span<Byte>, Int32)

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.Implements the ISerializable interface and is called back by the deserialization event when deserialization is complete.

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.Gets serialization information with all the data needed to recreate an instance of the current X509Certificate object.

Aplica-se a