X509Certificate Constructores

Definición

Inicializa una nueva instancia de la clase X509Certificate.

Sobrecargas

X509Certificate()
Obsoleto.

Inicializa una nueva instancia de la clase X509Certificate.

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(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(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(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, SecureString)

Inicializa una nueva instancia de la clase X509Certificate utilizando el nombre de un archivo de certificado y una contraseña.

X509Certificate(SerializationInfo, StreamingContext)

Inicializa una nueva instancia de la clase X509Certificate utilizando un objeto SerializationInfo y una estructura StreamingContext.

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(Byte[], SecureString)

Inicializa una nueva instancia de la clase X509Certificate utilizando una matriz de bytes y una contraseña.

X509Certificate(String)

Inicializa una nueva instancia de la clase X509Certificate usando el nombre de un archivo firmado con el estándar PKCS7.

X509Certificate(X509Certificate)

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

X509Certificate(IntPtr)

Inicializa una nueva instancia de la clase X509Certificate utilizando un identificador a una estructura PCCERT_CONTEXT no administrada.

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[], String)

Inicializa una nueva instancia de la clase X509Certificate utilizando una matriz de bytes y una contraseña.

X509Certificate()

Precaución

X509Certificate and X509Certificate2 are immutable. Use the appropriate constructor to create a new certificate.

Inicializa una nueva instancia de la clase X509Certificate.

public:
 X509Certificate();
public X509Certificate ();
[System.Obsolete("X509Certificate and X509Certificate2 are immutable. Use the appropriate constructor to create a new certificate.", DiagnosticId="SYSLIB0026", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public X509Certificate ();
[System.Obsolete("X509Certificate and X509Certificate2 are immutable. Use the appropriate constructor to create a new certificate.", DiagnosticId="SYSLIB0026", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate ();
Public Sub New ()
Atributos

Comentarios

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

Se aplica a

X509Certificate(String, SecureString, X509KeyStorageFlags)

Importante

Esta API no es conforme a CLS.

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.

public:
 X509Certificate(System::String ^ fileName, System::Security::SecureString ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
public X509Certificate (string fileName, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
public X509Certificate (string fileName, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
public X509Certificate (string fileName, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (fileName As String, password As SecureString, keyStorageFlags As X509KeyStorageFlags)

Parámetros

fileName
String

Nombre de un archivo de certificado.

password
SecureString

Contraseña requerida para obtener acceso a los datos del certificado X.509.

keyStorageFlags
X509KeyStorageFlags

Combinación bit a bit de los valores de enumeración que controlan dónde y cómo importar el certificado.

Atributos

Excepciones

Se genera un error con el certificado. Por ejemplo:

  • El archivo de certificado no existe.

  • El certificado no es válido.

  • La contraseña del certificado es incorrecta.

El parámetro fileName es null.

Comentarios

Si crea un X509Certificate certificado especificando un almacén de archivos firmado PKCS7 para fileName, X509Certificate se crea para el certificado que firmó el almacén en lugar de para cualquiera de los certificados del almacén.

Se aplica 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.

public:
 X509Certificate(cli::array <System::Byte> ^ rawData, System::String ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);
public X509Certificate (byte[] rawData, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] rawData, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
public X509Certificate (byte[] rawData, string password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (rawData As Byte(), password As String, keyStorageFlags As X509KeyStorageFlags)

Parámetros

rawData
Byte[]

Matriz de bytes que contiene los datos de un certificado X.509.

password
String

Contraseña requerida para obtener acceso a los datos del certificado X.509.

keyStorageFlags
X509KeyStorageFlags

Combinación bit a bit de los valores de enumeración que controlan dónde y cómo importar el certificado.

Atributos

Excepciones

Se genera un error con el certificado. Por ejemplo:

  • El archivo de certificado no existe.

  • El certificado no es válido.

  • La contraseña del certificado es incorrecta.

El parámetro rawData es null.

o bien La longitud del parámetro rawData es 0.

Comentarios

Este constructor crea un nuevo X509Certificate objeto mediante una matriz de bytes, una contraseña necesaria para acceder a los datos del certificado y una marca de almacenamiento de claves. Al llamar a este constructor con la contraseña correcta, se descifra la clave privada y se guarda en un proveedor de servicios criptográficos (CSP) de la API criptográfica de Microsoft.

El X509KeyStorageFlags valor se puede usar para controlar dónde y cómo se importa la clave privada.

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

Importante

Nunca codifique de forma rígida una contraseña en el código fuente. Las contraseñas codificadas de forma rígida se pueden recuperar de un ensamblado mediante el Ildasm.exe (Desensamblador de IL), un editor hexadecimal o simplemente abriendo el ensamblado en un editor de texto como Notepad.exe.

Si crea un X509Certificate certificado especificando un almacén de archivos firmado PKCS7 para rawData, X509Certificate se crea para el certificado que firmó el almacén en lugar de para cualquiera de los certificados del almacén.

Se aplica a

X509Certificate(Byte[], SecureString, X509KeyStorageFlags)

Importante

Esta API no es conforme a CLS.

Inicializa una nueva instancia de la clase X509Certificate utilizando una matriz de bytes, una contraseña y una marca de almacenamiento de claves.

public:
 X509Certificate(cli::array <System::Byte> ^ rawData, System::Security::SecureString ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
public X509Certificate (byte[] rawData, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] rawData, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
public X509Certificate (byte[] rawData, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
public X509Certificate (byte[] rawData, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (rawData As Byte(), password As SecureString, keyStorageFlags As X509KeyStorageFlags)

Parámetros

rawData
Byte[]

Matriz de bytes que contiene los datos de un certificado X.509.

password
SecureString

Contraseña requerida para obtener acceso a los datos del certificado X.509.

keyStorageFlags
X509KeyStorageFlags

Combinación bit a bit de los valores de enumeración que controlan dónde y cómo importar el certificado.

Atributos

Excepciones

Se genera un error con el certificado. Por ejemplo:

  • El archivo de certificado no existe.

  • El certificado no es válido.

  • La contraseña del certificado es incorrecta.

El parámetro rawData es null.

o bien La longitud del parámetro rawData es 0.

Comentarios

Al llamar a este constructor con la contraseña correcta, se descifra la clave privada y se guarda en un proveedor de servicios criptográficos (CSP) de la API criptográfica de Microsoft.

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

Importante

Nunca codifique de forma rígida una contraseña en el código fuente. Las contraseñas codificadas de forma rígida se pueden recuperar de un ensamblado mediante el Ildasm.exe (Desensamblador de IL), un editor hexadecimal o simplemente abriendo el ensamblado en un editor de texto como Notepad.exe.

Si crea un X509Certificate certificado especificando un almacén de archivos firmado PKCS7 para rawData, X509Certificate se crea para el certificado que firmó el almacén en lugar de para cualquiera de los certificados del almacén.

Se aplica a

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.

public:
 X509Certificate(System::String ^ fileName, System::String ^ password);
public X509Certificate (string fileName, string? password);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName, string? password);
public X509Certificate (string fileName, string password);
new System.Security.Cryptography.X509Certificates.X509Certificate : string * string -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * string -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (fileName As String, password As String)

Parámetros

fileName
String

Nombre de un archivo firmado con el estándar PKCS7.

password
String

Contraseña requerida para obtener acceso a los datos del certificado X.509.

Atributos

Excepciones

Se genera un error con el certificado. Por ejemplo:

  • El archivo de certificado no existe.

  • El certificado no es válido.

  • La contraseña del certificado es incorrecta.

El parámetro fileName es null.

Comentarios

ASN.1 DER es el único formato de certificado admitido por esta clase. Al llamar a este constructor con la contraseña correcta, se descifra la clave privada y se guarda en un contenedor de claves.

Si crea un X509Certificate certificado especificando un almacén de archivos firmado PKCS7 para fileName, X509Certificate se crea para el certificado que firmó el almacén en lugar de para cualquiera de los certificados del almacén.

Se aplica a

X509Certificate(String, SecureString)

Importante

Esta API no es conforme a CLS.

Inicializa una nueva instancia de la clase X509Certificate utilizando el nombre de un archivo de certificado y una contraseña.

public:
 X509Certificate(System::String ^ fileName, System::Security::SecureString ^ password);
[System.CLSCompliant(false)]
public X509Certificate (string fileName, System.Security.SecureString? password);
[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName, System.Security.SecureString? password);
[System.CLSCompliant(false)]
public X509Certificate (string fileName, System.Security.SecureString password);
public X509Certificate (string fileName, System.Security.SecureString password);
[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (fileName As String, password As SecureString)

Parámetros

fileName
String

Nombre de un archivo de certificado.

password
SecureString

Contraseña requerida para obtener acceso a los datos del certificado X.509.

Atributos

Excepciones

Se genera un error con el certificado. Por ejemplo:

  • El archivo de certificado no existe.

  • El certificado no es válido.

  • La contraseña del certificado es incorrecta.

El parámetro fileName es null.

Comentarios

ASN.1 DER es el único formato de certificado admitido por esta clase. Al llamar a este constructor con la contraseña correcta, se descifra la clave privada y se guarda en un contenedor de claves.

Importante

Nunca codifique de forma rígida una contraseña en el código fuente. Las contraseñas codificadas de forma rígida se pueden recuperar de un ensamblado mediante el Ildasm.exe (Desensamblador de IL), un editor hexadecimal o simplemente abriendo el ensamblado en un editor de texto como Notepad.exe.

Si crea un X509Certificate certificado especificando un almacén de archivos firmado PKCS7 para fileName, X509Certificate se crea para el certificado que firmó el almacén en lugar de para cualquiera de los certificados del almacén.

Se aplica a

X509Certificate(SerializationInfo, StreamingContext)

Inicializa una nueva instancia de la clase X509Certificate utilizando un objeto SerializationInfo y una estructura StreamingContext.

public:
 X509Certificate(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);
public X509Certificate (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
new System.Security.Cryptography.X509Certificates.X509Certificate : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (info As SerializationInfo, context As StreamingContext)

Parámetros

info
SerializationInfo

Objeto SerializationInfo que describe información de serialización.

context
StreamingContext

Estructura StreamingContext que describe cómo se debería realizar la serialización.

Excepciones

Se genera un error con el certificado. Por ejemplo:

  • El archivo de certificado no existe.

  • El certificado no es válido.

  • La contraseña del certificado es incorrecta.

Se aplica a

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.

public:
 X509Certificate(System::String ^ fileName, System::String ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);
public X509Certificate (string fileName, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
public X509Certificate (string fileName, string password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
new System.Security.Cryptography.X509Certificates.X509Certificate : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (fileName As String, password As String, keyStorageFlags As X509KeyStorageFlags)

Parámetros

fileName
String

Nombre de un archivo firmado con el estándar PKCS7.

password
String

Contraseña requerida para obtener acceso a los datos del certificado X.509.

keyStorageFlags
X509KeyStorageFlags

Combinación bit a bit de los valores de enumeración que controlan dónde y cómo importar el certificado.

Atributos

Excepciones

Se genera un error con el certificado. Por ejemplo:

  • El archivo de certificado no existe.

  • El certificado no es válido.

  • La contraseña del certificado es incorrecta.

El parámetro fileName es null.

Comentarios

Si crea un X509Certificate certificado especificando un almacén de archivos firmado PKCS7 para fileName, X509Certificate se crea para el certificado que firmó el almacén en lugar de para cualquiera de los certificados del almacén.

Se aplica a

X509Certificate(Byte[], SecureString)

Importante

Esta API no es conforme a CLS.

Inicializa una nueva instancia de la clase X509Certificate utilizando una matriz de bytes y una contraseña.

public:
 X509Certificate(cli::array <System::Byte> ^ rawData, System::Security::SecureString ^ password);
[System.CLSCompliant(false)]
public X509Certificate (byte[] rawData, System.Security.SecureString? password);
[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] rawData, System.Security.SecureString? password);
[System.CLSCompliant(false)]
public X509Certificate (byte[] rawData, System.Security.SecureString password);
public X509Certificate (byte[] rawData, System.Security.SecureString password);
[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (rawData As Byte(), password As SecureString)

Parámetros

rawData
Byte[]

Matriz de bytes que contiene los datos de un certificado X.509.

password
SecureString

Contraseña requerida para obtener acceso a los datos del certificado X.509.

Atributos

Excepciones

Se genera un error con el certificado. Por ejemplo:

  • El archivo de certificado no existe.

  • El certificado no es válido.

  • La contraseña del certificado es incorrecta.

El parámetro rawData es null.

o bien La longitud del parámetro rawData es 0.

Comentarios

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

Importante

Nunca codifique de forma rígida una contraseña dentro del código fuente. Las contraseñas codificadas de forma rígida se pueden recuperar de un ensamblado mediante el Ildasm.exe (Desensamblador de IL), un editor hexadecimal o simplemente abriendo el ensamblado en un editor de texto, como Notepad.exe.

Si crea un X509Certificate certificado especificando un almacén de archivos firmado PKCS7 para rawData, X509Certificate se crea para el certificado que firmó el almacén en lugar de para cualquiera de los certificados del almacén.

Se aplica a

X509Certificate(String)

Inicializa una nueva instancia de la clase X509Certificate usando el nombre de un archivo firmado con el estándar PKCS7.

public:
 X509Certificate(System::String ^ fileName);
public X509Certificate (string fileName);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName);
new System.Security.Cryptography.X509Certificates.X509Certificate : string -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (fileName As String)

Parámetros

fileName
String

Nombre de un archivo firmado con el estándar PKCS7.

Atributos

Excepciones

Se genera un error con el certificado. Por ejemplo:

  • El archivo de certificado no existe.

  • El certificado no es válido.

  • La contraseña del certificado es incorrecta.

El parámetro fileName es null.

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.

Si crea un X509Certificate certificado especificando un almacén de archivos firmado PKCS7 para fileName, X509Certificate se crea para el certificado que firmó el almacén en lugar de para cualquiera de los certificados del almacén.

Se aplica a

X509Certificate(X509Certificate)

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

public:
 X509Certificate(System::Security::Cryptography::X509Certificates::X509Certificate ^ cert);
public X509Certificate (System.Security.Cryptography.X509Certificates.X509Certificate cert);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (System.Security.Cryptography.X509Certificates.X509Certificate cert);
new System.Security.Cryptography.X509Certificates.X509Certificate : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (cert As X509Certificate)

Parámetros

cert
X509Certificate

Clase X509Certificate a partir de la que se va a inicializar esta clase.

Atributos

Excepciones

Se genera un error con el certificado. Por ejemplo:

  • El archivo de certificado no existe.

  • El certificado no es válido.

  • La contraseña del certificado es incorrecta.

El valor del parámetro cert es null.

Comentarios

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

Se aplica a

X509Certificate(IntPtr)

Inicializa una nueva instancia de la clase X509Certificate utilizando un identificador a una estructura PCCERT_CONTEXT no administrada.

public:
 X509Certificate(IntPtr handle);
public X509Certificate (IntPtr handle);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (IntPtr handle);
[System.Security.SecurityCritical]
public X509Certificate (IntPtr handle);
new System.Security.Cryptography.X509Certificates.X509Certificate : nativeint -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : nativeint -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Security.SecurityCritical>]
new System.Security.Cryptography.X509Certificates.X509Certificate : nativeint -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (handle As IntPtr)

Parámetros

handle
IntPtr

nativeint

Identificador para una estructura PCCERT_CONTEXT no administrada.

Atributos

Excepciones

Se genera un error con el certificado. Por ejemplo:

  • El archivo de certificado no existe.

  • El certificado no es válido.

  • La contraseña del certificado es incorrecta.

El parámetro de identificador no representa una estructura PCCERT_CONTEXT válida.

Comentarios

Este constructor crea un nuevo X509Certificate objeto mediante un identificador para el contexto de certificado de la API criptográfica de Microsoft, PCCERT_CONTEXT.

Importante

Este constructor crea una copia del contexto del certificado. No suponga que la estructura de contexto que ha pasado al constructor es válida; es posible que se haya liberado. Puede obtener una copia de la estructura actual PCCERT_CONTEXT de la Handle propiedad , pero solo es válida durante la vigencia del X509Certificate objeto.

Se aplica a

X509Certificate(Byte[])

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

public:
 X509Certificate(cli::array <System::Byte> ^ data);
public X509Certificate (byte[] data);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] data);
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (data As Byte())

Parámetros

data
Byte[]

Matriz de bytes que contiene los datos de un certificado X.509.

Atributos

Excepciones

Se genera un error con el certificado. Por ejemplo:

  • El archivo de certificado no existe.

  • El certificado no es válido.

  • La contraseña del certificado es incorrecta.

El parámetro rawData es null.

o bien La longitud del parámetro rawData es 0.

Ejemplos

En el ejemplo siguiente se carga un archivo de certificado X.509 en un X509Certificate objeto , se exporta el certificado como una matriz de bytes y, a continuación, se importa la matriz de bytes en otro X509Certificate objeto .

using namespace System;
using namespace System::Security::Cryptography::X509Certificates;
int main()
{
   
   // The path to the certificate.
   String^ Certificate = L"test.pfx";
   
   // Load the certificate into an X509Certificate object.
   X509Certificate^ cert = gcnew X509Certificate( Certificate );
   array<Byte>^certData = cert->Export( X509ContentType::Cert );
   X509Certificate^ newCert = gcnew X509Certificate( certData );
   
   // Get the value.
   String^ resultsTrue = newCert->ToString( true );
   
   // Display the value to the console.
   Console::WriteLine( resultsTrue );
   
   // Get the value.
   String^ resultsFalse = newCert->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 = "test.pfx";

        // Load the certificate into an X509Certificate object.
        X509Certificate cert = new X509Certificate(Certificate);

        byte[] certData = cert.Export(X509ContentType.Cert);

        X509Certificate newCert = new X509Certificate(certData);

        // Get the value.
        string resultsTrue = newCert.ToString(true);

        // Display the value to the console.
        Console.WriteLine(resultsTrue);

        // Get the value.
        string resultsFalse = newCert.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 = "test.pfx"

        ' Load the certificate into an X509Certificate object.
        Dim cert As New X509Certificate(Certificate)


        Dim certData As Byte() = cert.Export(X509ContentType.Cert)

        Dim newCert As New X509Certificate(certData)

        ' Get the value.
        Dim resultsTrue As String = newCert.ToString(True)

        ' Display the value to the console.
        Console.WriteLine(resultsTrue)

        ' Get the value.
        Dim resultsFalse As String = newCert.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.

Si crea un X509Certificate certificado especificando un almacén de archivos firmado PKCS7 para data, X509Certificate se crea para el certificado que firmó el almacén en lugar de para cualquiera de los certificados del almacén.

Se aplica a

X509Certificate(Byte[], String)

Inicializa una nueva instancia de la clase X509Certificate utilizando una matriz de bytes y una contraseña.

public:
 X509Certificate(cli::array <System::Byte> ^ rawData, System::String ^ password);
public X509Certificate (byte[] rawData, string? password);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] rawData, string? password);
public X509Certificate (byte[] rawData, string password);
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * string -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * string -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (rawData As Byte(), password As String)

Parámetros

rawData
Byte[]

Matriz de bytes que contiene los datos de un certificado X.509.

password
String

Contraseña requerida para obtener acceso a los datos del certificado X.509.

Atributos

Excepciones

Se genera un error con el certificado. Por ejemplo:

  • El archivo de certificado no existe.

  • El certificado no es válido.

  • La contraseña del certificado es incorrecta.

El parámetro rawData es null.

o bien La longitud del parámetro rawData es 0.

Comentarios

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

Importante

Nunca codifique de forma rígida una contraseña dentro del código fuente. Las contraseñas codificadas de forma rígida se pueden recuperar de un ensamblado mediante el Ildasm.exe (Desensamblador de IL), un editor hexadecimal o simplemente abriendo el ensamblado en un editor de texto, como Notepad.exe.

Si crea un X509Certificate certificado especificando un almacén de archivos firmado PKCS7 para rawData, X509Certificate se crea para el certificado que firmó el almacén en lugar de para cualquiera de los certificados del almacén.

Se aplica a