X509Certificate Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 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
-
X509Certificate
- Derivado
- Atributos
- Implementações
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.
Obsoleto.
Inicializa uma nova instância da classe X509Certificate. |
X509Certificate(Byte[]) |
Obsoleto.
Inicializa uma nova instância da classe X509Certificate definida de uma sequência de bytes que representa um certificado X.509v3. |
X509Certificate(Byte[], SecureString) |
Obsoleto.
Inicializa uma nova instância da classe X509Certificate usando uma matriz de bytes e uma senha. |
X509Certificate(Byte[], SecureString, X509KeyStorageFlags) |
Obsoleto.
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) |
Obsoleto.
Inicializa uma nova instância da classe X509Certificate usando uma matriz de bytes e uma senha. |
X509Certificate(Byte[], String, X509KeyStorageFlags) |
Obsoleto.
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 |
X509Certificate(SerializationInfo, StreamingContext) |
Obsoleto.
Inicializa uma nova instância da classe X509Certificate usando um objeto SerializationInfo e uma estrutura StreamingContext. |
X509Certificate(String) |
Obsoleto.
Inicializa uma nova instância da classe X509Certificate usando o nome de um arquivo assinado PKCS7. |
X509Certificate(String, SecureString) |
Obsoleto.
Inicializa uma nova instância da classe X509Certificate usando um nome de arquivo de certificado e uma senha. |
X509Certificate(String, SecureString, X509KeyStorageFlags) |
Obsoleto.
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) |
Obsoleto.
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) |
Obsoleto.
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 |
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) |
Obsoleto.
Cria um certificado X.509v3 com base no arquivo assinado PKCS7 especificado. |
CreateFromSignedFile(String) |
Obsoleto.
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(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
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.
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 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.
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 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.
Obsoleto.
Preenche o objeto X509Certificate com os dados de uma matriz de bytes. |
Import(Byte[], SecureString, X509KeyStorageFlags) |
Obsoleto.
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.
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.
Obsoleto.
Popula o objeto X509Certificate com informações de um arquivo de certificado. |
Import(String, SecureString, X509KeyStorageFlags) |
Obsoleto.
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.
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. |
Aplica-se a
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários