X509Certificate Constructores

Definición

Espacio de nombres:

System.Security.Cryptography.X509Certificates

Ensamblado:

System.Security.Cryptography.dll

Inicializa una nueva instancia de la clase X509Certificate.

Sobrecargas

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(IntPtr)	Inicializa una nueva instancia de la clase X509Certificate utilizando un identificador a una estructura PCCERT_CONTEXT no administrada.
X509Certificate(X509Certificate)	Inicializa una nueva instancia de la clase X509Certificate utilizando otra clase X509Certificate.
X509Certificate(String)	Inicializa una nueva instancia de la clase X509Certificate usando el nombre de un archivo firmado con el estándar PKCS7.
X509Certificate(Byte[], SecureString)	Inicializa una nueva instancia de la clase X509Certificate utilizando una matriz de bytes y una contraseña.
X509Certificate(Byte[], String)	Inicializa una nueva instancia de la clase X509Certificate utilizando una matriz de bytes y una contraseña.
X509Certificate(SerializationInfo, StreamingContext)	Obsoletos. Inicializa una nueva instancia de la clase X509Certificate utilizando un objeto SerializationInfo y una estructura StreamingContext.
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, 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(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, 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, 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, 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()

Source:

X509Certificate.cs

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();

[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

ObsoleteAttribute UnsupportedOSPlatformAttribute

Comentarios

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

X509Certificate(Byte[])

Source:

X509Certificate.cs

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);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] data);

[<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

UnsupportedOSPlatformAttribute

Excepciones

CryptographicException

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.

ArgumentException

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.

X509Certificate(IntPtr)

Source:

X509Certificate.cs

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

public:
 X509Certificate(IntPtr handle);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (IntPtr handle);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
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

UnsupportedOSPlatformAttribute

Excepciones

CryptographicException

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.

ArgumentException

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.

X509Certificate(X509Certificate)

Source:

X509Certificate.cs

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

public:
 X509Certificate(System::Security::Cryptography::X509Certificates::X509Certificate ^ cert);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (System.Security.Cryptography.X509Certificates.X509Certificate cert);

[<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

UnsupportedOSPlatformAttribute

Excepciones

CryptographicException

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.

ArgumentNullException

El valor del parámetro cert es null.

Comentarios

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

X509Certificate(String)

Source:

X509Certificate.cs

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);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName);

[<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

UnsupportedOSPlatformAttribute

Excepciones

CryptographicException

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.

ArgumentException

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.

X509Certificate(Byte[], SecureString)

Source:

X509Certificate.cs

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)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] rawData, System.Security.SecureString? password);

[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
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

CLSCompliantAttribute UnsupportedOSPlatformAttribute

Excepciones

CryptographicException

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.

ArgumentException

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.

X509Certificate(Byte[], String)

Source:

X509Certificate.cs

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);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] rawData, string? password);

[<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

UnsupportedOSPlatformAttribute

Excepciones

CryptographicException

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.

ArgumentException

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.

X509Certificate(SerializationInfo, StreamingContext)

Source:

X509Certificate.cs

Precaución

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

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);

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public X509Certificate (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
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.

Atributos

ObsoleteAttribute

Excepciones

CryptographicException

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.

X509Certificate(String, SecureString)

Source:

X509Certificate.cs

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)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName, System.Security.SecureString? password);

[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
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

CLSCompliantAttribute UnsupportedOSPlatformAttribute

Excepciones

CryptographicException

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.

ArgumentException

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 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 fileName, X509Certificate se crea para el certificado que firmó el almacén en lugar de para cualquiera de los certificados del almacén.

X509Certificate(String, String)

Source:

X509Certificate.cs

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);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName, string? password);

[<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

UnsupportedOSPlatformAttribute

Excepciones

CryptographicException

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.

ArgumentException

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.

X509Certificate(Byte[], SecureString, X509KeyStorageFlags)

Source:

X509Certificate.cs

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)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] rawData, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[<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

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

CLSCompliantAttribute UnsupportedOSPlatformAttribute

Excepciones

CryptographicException

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.

ArgumentException

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

X509Certificate(Byte[], String, X509KeyStorageFlags)

Source:

X509Certificate.cs

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);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] rawData, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[<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

UnsupportedOSPlatformAttribute

Excepciones

CryptographicException

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.

ArgumentException

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

X509Certificate(String, SecureString, X509KeyStorageFlags)

Source:

X509Certificate.cs

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)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[<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

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

CLSCompliantAttribute UnsupportedOSPlatformAttribute

Excepciones

CryptographicException

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.

ArgumentException

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.

X509Certificate(String, String, X509KeyStorageFlags)

Source:

X509Certificate.cs

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);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[<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

UnsupportedOSPlatformAttribute

Excepciones

CryptographicException

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.

ArgumentException

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.