X509Certificate Clase

Definición

Espacio de nombres:

System.Security.Cryptography.X509Certificates

Ensamblado:

System.Security.Cryptography.dll

Source:

X509Certificate.cs

Proporciona métodos para ayudarle a utilizar 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

Herencia

Object

X509Certificate

Derivado

System.Security.Cryptography.X509Certificates.X509Certificate2

Implementaciones

IDisposable IDeserializationCallback ISerializable

Ejemplos

En el ejemplo siguiente se carga un certificado X.509 desde un archivo, se llama al ToString método y se muestran los resultados en la consola.

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

Comentarios

ASN.1 DER es el único formato de certificado admitido por esta clase.

En la mayoría de los escenarios, debe usar la X509Certificate2 clase en su lugar.

Importante

A partir de .NET Framework 4.6, este tipo implementa la IDisposable interfaz . Cuando haya terminado de utilizar el tipo, debe desecharlo directa o indirectamente. Para eliminar el tipo directamente, llame a su método Dispose en un bloque try/catch. Para deshacerse de él indirectamente, use una construcción de lenguaje como using (en C#) o Using (en Visual Basic). Para más información, vea la sección "Uso de objetos que implementan IDisposable" en el tema de la interfaz IDisposable.

En el caso de las aplicaciones destinadas a .NET Framework 4.5.2 y versiones anteriores, la X509Certificate clase no implementa la IDisposable interfaz y, por lo tanto, no tiene un Dispose método.

Constructores

X509Certificate()	Obsoletos. Inicializa una nueva instancia de la clase X509Certificate.
X509Certificate(Byte[])	Inicializa una nueva instancia de la clase X509Certificate definida a partir de una secuencia de bytes que representa un certificado X.509v3.
X509Certificate(Byte[], SecureString)	Inicializa una nueva instancia de la clase X509Certificate utilizando una matriz de bytes y una contraseña.
X509Certificate(Byte[], SecureString, X509KeyStorageFlags)	Inicializa una nueva instancia de la clase X509Certificate utilizando una matriz de bytes, una contraseña y una marca de almacenamiento de claves.
X509Certificate(Byte[], String)	Inicializa una nueva instancia de la clase X509Certificate utilizando una matriz de bytes y una contraseña.
X509Certificate(Byte[], String, X509KeyStorageFlags)	Inicializa una nueva instancia de la clase X509Certificate utilizando una matriz de bytes, una contraseña y una marca de almacenamiento de claves.
X509Certificate(IntPtr)	Inicializa una nueva instancia de la clase X509Certificate utilizando un identificador a una estructura PCCERT_CONTEXT no administrada.
X509Certificate(SerializationInfo, StreamingContext)	Obsoletos. Inicializa una nueva instancia de la clase X509Certificate utilizando un objeto SerializationInfo y una estructura StreamingContext.
X509Certificate(String)	Inicializa una nueva instancia de la clase X509Certificate usando el nombre de un archivo firmado con el estándar PKCS7.
X509Certificate(String, SecureString)	Inicializa una nueva instancia de la clase X509Certificate utilizando el nombre de un archivo de certificado y una contraseña.
X509Certificate(String, SecureString, X509KeyStorageFlags)	Inicializa una nueva instancia de la clase X509Certificate utilizando el nombre de un archivo de certificado, una contraseña y una marca de almacenamiento de claves.
X509Certificate(String, String)	Inicializa una nueva instancia de la clase X509Certificate usando el nombre de un archivo firmado con el estándar PKCS7 y una contraseña para obtener acceso al certificado.
X509Certificate(String, String, X509KeyStorageFlags)	Inicializa una nueva instancia de la clase X509Certificate usando el nombre de un archivo firmado con el estándar PKCS7, una contraseña para obtener acceso al certificado y una marca de almacenamiento de claves.
X509Certificate(X509Certificate)	Inicializa una nueva instancia de la clase X509Certificate utilizando otra clase X509Certificate.

Propiedades

Handle	Obtiene un identificador para un contexto de certificado de la API de criptografía de Microsoft descrito por una estructura PCCERT_CONTEXT no administrada.
Issuer	Obtiene el nombre de la entidad de certificación que emitió el certificado X.509v3.
SerialNumberBytes	Obtiene la representación big-endian del número de serie del certificado.
Subject	Obtiene el nombre distintivo del sujeto del certificado.

Métodos

CreateFromCertFile(String)	Crea un certificado X.509v3 a partir del archivo firmado con el estándar PKCS7 especificado.
CreateFromSignedFile(String)	Crea un certificado X.509v3 a partir del archivo de certificación especificado.
Dispose()	Libera todos los recursos que usa el objeto X509Certificate actual.
Dispose(Boolean)	Libera todos los recursos no administrados que este X509Certificate usa y libera los recursos administrados de forma opcional.
Equals(Object)	Compara dos objetos X509Certificate para determinar si son iguales.
Equals(X509Certificate)	Compara dos objetos X509Certificate para determinar si son iguales.
Export(X509ContentType)	Exporta el objeto X509Certificate actual a una matriz de bytes en un formato descrito por uno de los valores de X509ContentType.
Export(X509ContentType, SecureString)	Exporta el objeto X509Certificate actual a una matriz de bytes utilizando el formato especificado y una contraseña.
Export(X509ContentType, String)	Exporta el objeto X509Certificate actual a una matriz de bytes en un formato descrito por uno de los valores de X509ContentType, con la contraseña especificada.
FormatDate(DateTime)	Convierte la fecha y la hora especificadas en una cadena.
GetCertHash()	Devuelve el valor hash del certificado X.509v3 en forma de matriz de bytes.
GetCertHash(HashAlgorithmName)	Devuelve el valor hash del certificado X.509v3 que se calcula mediante el algoritmo hash criptográfico especificado.
GetCertHashString()	Devuelve el valor de hash SHA1 del certificado X.509v3 en forma de una cadena hexadecimal.
GetCertHashString(HashAlgorithmName)	Devuelve una cadena hexadecimal que contiene el valor hash del certificado X.509v3 que se calcula mediante el algoritmo hash criptográfico especificado.
GetEffectiveDateString()	Devuelve la fecha efectiva de este certificado X.509v3.
GetExpirationDateString()	Devuelve la fecha de expiración de este certificado X.509v3.
GetFormat()	Devuelve el nombre del formato de este certificado X.509v3.
GetHashCode()	Devuelve el código hash del certificado X.509v3 en forma de entero.
GetIssuerName()	Obsoletos. Devuelve el nombre de la entidad de certificación que emitió el certificado X.509v3.
GetKeyAlgorithm()	Devuelve la información del algoritmo de clave de este certificado X.509v3 como una cadena.
GetKeyAlgorithmParameters()	Devuelve los parámetros del algoritmo de clave del certificado X.509v3 en forma de matriz de bytes.
GetKeyAlgorithmParametersString()	Devuelve los parámetros del algoritmo de clave del certificado X.509v3 como una cadena hexadecimal.
GetName()	Obsoletos. Devuelve el nombre de la entidad de seguridad a la que se emitió el certificado.
GetPublicKey()	Devuelve la clave pública del certificado X.509v3 en forma de matriz de bytes.
GetPublicKeyString()	Devuelve la clave pública del certificado X.509v3 en forma de cadena hexadecimal.
GetRawCertData()	Devuelve los datos sin procesar del certificado X.509v3 completo en forma de matriz de bytes.
GetRawCertDataString()	Devuelve los datos sin procesar del certificado X.509v3 completo en forma de cadena hexadecimal.
GetSerialNumber()	Devuelve el número de serie del certificado X.509v3 en forma de matriz de bytes en orden little-endian.
GetSerialNumberString()	Devuelve el número de serie del certificado X.509v3 en forma de cadena hexadecimal little-endian.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
Import(Byte[])	Obsoletos. Rellena el objeto X509Certificate con datos de una matriz de bytes.
Import(Byte[], SecureString, X509KeyStorageFlags)	Obsoletos. Rellena un objeto X509Certificate utilizando los datos de una matriz de bytes, una contraseña y una marca de almacenamiento de claves.
Import(Byte[], String, X509KeyStorageFlags)	Obsoletos. Rellena el objeto X509Certificate utilizando los datos de una matriz de bytes, una contraseña y marcas para determinar cómo se importa la clave privada.
Import(String)	Obsoletos. Rellena el objeto X509Certificate con información de un archivo de certificado.
Import(String, SecureString, X509KeyStorageFlags)	Obsoletos. Rellena un objeto X509Certificate con información de un archivo de certificado, una contraseña y una marca de almacenamiento de claves.
Import(String, String, X509KeyStorageFlags)	Obsoletos. Rellena el objeto X509Certificate con información de un archivo de certificado, una contraseña y un valor de X509KeyStorageFlags.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
Reset()	Restablece el estado del objeto X509Certificate2.
ToString()	Devuelve una representación en forma de cadena del objeto X509Certificate actual.
ToString(Boolean)	Devuelve una representación en forma de cadena del objeto X509Certificate actual con información adicional, si se especifica.
TryGetCertHash(HashAlgorithmName, Span<Byte>, Int32)	Intenta generar una "huella digital" para el certificado aplicando un algoritmo hash a la representación codificada del certificado con el algoritmo hash especificado.

Implementaciones de interfaz explícitas

IDeserializationCallback.OnDeserialization(Object)	Implementa la interfaz ISerializable. El evento de deserialización vuelve a llamar a este método cuando se completa la deserialización.
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Obtiene información de serialización con todos los datos necesarios para volver a crear una instancia del objeto X509Certificate actual.