X509Certificate Clase

Definición

Espacio de nombres:
System.Security.Cryptography.X509Certificates
Ensamblados:
netstandard.dll, System.Security.Cryptography.dll
Ensamblados:
netstandard.dll, System.Security.Cryptography.X509Certificates.dll
Ensamblados:
netstandard.dll, System.Security.Cryptography.dll, System.Security.Cryptography.X509Certificates.dll
Ensamblado:
System.Security.Cryptography.X509Certificates.dll
Ensamblado:
mscorlib.dll
Ensamblado:
netstandard.dll
Source:
X509Certificate.cs
Source:
X509Certificate.cs
Source:
X509Certificate.cs
Source:
X509Certificate.cs
Source:
X509Certificate.cs

Proporciona métodos que le ayudan 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
Herencia
Object
X509Certificate
Derivado
Atributos
SerializableAttribute ComVisibleAttribute
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 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 eliminarlo indirectamente, use una construcción de lenguaje como using (en C#) o Using (en Visual Basic). Para obtener más información, vea la sección "Using an Object that Implements IDisposable" (Usar un objeto que implementa IDisposable) en el tema de interfaz IDisposable .

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

Constructores

Nombre Description
X509Certificate()
Obsoletos.
Obsoletos.

Inicializa una nueva instancia de la clase X509Certificate.
X509Certificate(Byte[], SecureString, X509KeyStorageFlags)
Obsoletos.

Inicializa una nueva instancia de la X509Certificate clase mediante una matriz de bytes, una contraseña y una marca de almacenamiento de claves.
X509Certificate(Byte[], SecureString)
Obsoletos.

Inicializa una nueva instancia de la X509Certificate clase mediante una matriz de bytes y una contraseña.
X509Certificate(Byte[], String, X509KeyStorageFlags)
Obsoletos.

Inicializa una nueva instancia de la X509Certificate clase mediante una matriz de bytes, una contraseña y una marca de almacenamiento de claves.
X509Certificate(Byte[], String)
Obsoletos.

Inicializa una nueva instancia de la X509Certificate clase mediante una matriz de bytes y una contraseña.
X509Certificate(Byte[])
Obsoletos.

Inicializa una nueva instancia de la X509Certificate clase definida a partir de una secuencia de bytes que representa un certificado X.509v3.
X509Certificate(IntPtr)

Inicializa una nueva instancia de la X509Certificate clase mediante un identificador para una estructura no administrada PCCERT_CONTEXT .
X509Certificate(SerializationInfo, StreamingContext)
Obsoletos.

Inicializa una nueva instancia de la X509Certificate clase mediante un SerializationInfo objeto y una StreamingContext estructura.
X509Certificate(String, SecureString, X509KeyStorageFlags)
Obsoletos.

Inicializa una nueva instancia de la X509Certificate clase mediante un nombre de archivo de certificado, una contraseña y una marca de almacenamiento de claves.
X509Certificate(String, SecureString)
Obsoletos.

Inicializa una nueva instancia de la X509Certificate clase utilizando un nombre de archivo de certificado y una contraseña.
X509Certificate(String, String, X509KeyStorageFlags)
Obsoletos.

Inicializa una nueva instancia de la X509Certificate clase con el nombre de un archivo firmado PKCS7, una contraseña para acceder al certificado y una marca de almacenamiento de claves.
X509Certificate(String, String)
Obsoletos.

Inicializa una nueva instancia de la X509Certificate clase con el nombre de un archivo firmado PKCS7 y una contraseña para acceder al certificado.
X509Certificate(String)
Obsoletos.

Inicializa una nueva instancia de la X509Certificate clase utilizando el nombre de un archivo firmado PKCS7.
X509Certificate(X509Certificate)

Inicializa una nueva instancia de la X509Certificate clase mediante otra X509Certificate clase.

Propiedades

Nombre Description
Handle

Obtiene un identificador para un contexto de certificado de LA API criptográfica de Microsoft descrito por una estructura no administrada PCCERT_CONTEXT .
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 firmante del certificado.

Métodos

Nombre Description
CreateFromCertFile(String)
Obsoletos.

Crea un certificado X.509v3 a partir del archivo firmado PKCS7 especificado.
CreateFromSignedFile(String)
Obsoletos.

Crea un certificado X.509v3 a partir del archivo firmado especificado.
Dispose()

Libera todos los recursos utilizados por el objeto actual X509Certificate .
Dispose(Boolean)

Libera todos los recursos no administrados que usa y X509Certificate , opcionalmente, libera los recursos administrados.
Equals(Object)

Compara dos objetos X509Certificate para determinar si son iguales.
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.

(Heredado de Object)
Equals(X509Certificate)

Compara dos objetos X509Certificate para determinar si son iguales.
Export(X509ContentType, SecureString)

Exporta el objeto actual X509Certificate a una matriz de bytes mediante el formato especificado y una contraseña.
Export(X509ContentType, String)

Exporta el objeto actual X509Certificate a una matriz de bytes en un formato descrito por uno de los X509ContentType valores y utilizando la contraseña especificada.
Export(X509ContentType)

Exporta el objeto actual X509Certificate a una matriz de bytes en un formato descrito por uno de los X509ContentType valores.
ExportPkcs12(PbeParameters, String)

Exporta el certificado y la clave privada en formato PKCS#12 /PFX.
ExportPkcs12(Pkcs12ExportPbeParameters, String)

Exporta el certificado y la clave privada en formato PKCS#12 /PFX.
FormatDate(DateTime)

Convierte la fecha y hora especificadas en una cadena.
GetCertHash()

Devuelve el valor hash del certificado X.509v3 como una 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 hash SHA-1 del certificado X.509v3 como una cadena hexadecimal.
GetCertHashString(HashAlgorithmName)

Devuelve una cadena hexadecimal que contiene el valor hash del certificado X.509v3 calculado 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 como un entero.
GetIssuerName()
Obsoletos.
Obsoletos.
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 para este certificado X.509v3 como una cadena.
GetKeyAlgorithmParameters()

Devuelve los parámetros del algoritmo de clave para el certificado X.509v3 como una matriz de bytes.
GetKeyAlgorithmParametersString()

Devuelve los parámetros del algoritmo de clave para el certificado X.509v3 como una cadena hexadecimal.
GetName()
Obsoletos.
Obsoletos.
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 como una matriz de bytes.
GetPublicKeyString()

Devuelve la clave pública del certificado X.509v3 como una cadena hexadecimal.
GetRawCertData()

Devuelve los datos sin procesar del certificado X.509v3 completo como una matriz de bytes.
GetRawCertDataString()

Devuelve los datos sin procesar del certificado X.509v3 completo como una cadena hexadecimal.
GetSerialNumber()

Devuelve el número de serie del certificado X.509v3 como una matriz de bytes en orden little-endian.
GetSerialNumberString()

Devuelve el número de serie del certificado X.509v3 como una cadena hexadecimal big-endian.
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
Import(Byte[], SecureString, X509KeyStorageFlags)
Obsoletos.
Obsoletos.

Rellena un X509Certificate objeto mediante datos de una matriz de bytes, una contraseña y una marca de almacenamiento de claves.
Import(Byte[], String, X509KeyStorageFlags)
Obsoletos.
Obsoletos.

Rellena el X509Certificate objeto mediante datos de una matriz de bytes, una contraseña y marcas para determinar cómo se importa la clave privada.
Import(Byte[])
Obsoletos.
Obsoletos.

Rellena el X509Certificate objeto con datos de una matriz de bytes.
Import(String, SecureString, X509KeyStorageFlags)
Obsoletos.
Obsoletos.

Rellena un X509Certificate objeto con información de un archivo de certificado, una contraseña y una marca de almacenamiento de claves.
Import(String, String, X509KeyStorageFlags)
Obsoletos.
Obsoletos.

Rellena el X509Certificate objeto con información de un archivo de certificado, una contraseña y un X509KeyStorageFlags valor.
Import(String)
Obsoletos.
Obsoletos.

Rellena el X509Certificate objeto con información de un archivo de certificado.
MemberwiseClone()

Crea una copia superficial del Objectactual.

(Heredado de Object)
Reset()

Restablece el estado del X509Certificate2 objeto.
ToString()

Devuelve una representación de cadena del objeto actual X509Certificate .
ToString(Boolean)

Devuelve una representación de cadena del objeto actual X509Certificate , con información adicional, si se especifica.
TryGetCertHash(HashAlgorithmName, Span<Byte>, Int32)

Intenta generar una "huella digital" para el certificado mediante el hash de la representación codificada del certificado con el algoritmo hash especificado.

Implementaciones de interfaz explícitas

Nombre Description
IDeserializationCallback.OnDeserialization(Object)

Implementa la ISerializable interfaz y la llama de nuevo el evento de deserialización 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 actual X509Certificate .

Se aplica a