X509Certificate2 Constructores

Definición

Inicializa una nueva instancia de la clase X509Certificate2.Initializes a new instance of the X509Certificate2 class.

Sobrecargas

X509Certificate2()

Inicializa una nueva instancia de la clase X509Certificate2.Initializes a new instance of the X509Certificate2 class.

X509Certificate2(String, String, X509KeyStorageFlags)

Inicializa una nueva instancia de la clase X509Certificate2 utilizando el nombre de un archivo de certificado, una contraseña para obtener acceso al certificado y una marca de almacenamiento claves.Initializes a new instance of the X509Certificate2 class using a certificate file name, a password used to access the certificate, and a key storage flag.

X509Certificate2(String, SecureString, X509KeyStorageFlags)

Inicializa una nueva instancia de la clase X509Certificate2 utilizando el nombre de un archivo de certificado, una contraseña y una marca de almacenamiento de claves.Initializes a new instance of the X509Certificate2 class using a certificate file name, a password, and a key storage flag.

X509Certificate2(Byte[], String, X509KeyStorageFlags)

Inicializa una nueva instancia de la clase X509Certificate2 utilizando una matriz de bytes, una contraseña y una marca de almacenamiento de claves.Initializes a new instance of the X509Certificate2 class using a byte array, a password, and a key storage flag.

X509Certificate2(String, String)

Inicializa una nueva instancia de la clase X509Certificate2 utilizando el nombre de un archivo de certificado y una contraseña para obtener acceso al certificado.Initializes a new instance of the X509Certificate2 class using a certificate file name and a password used to access the certificate.

X509Certificate2(String, SecureString)

Inicializa una nueva instancia de la clase X509Certificate2 utilizando el nombre de un archivo de certificado y una contraseña.Initializes a new instance of the X509Certificate2 class using a certificate file name and a password.

X509Certificate2(SerializationInfo, StreamingContext)

Inicializa una nueva instancia de la clase X509Certificate2 utilizando la información de serialización y el contexto de secuencia especificados.Initializes a new instance of the X509Certificate2 class using the specified serialization and stream context information.

X509Certificate2(Byte[], SecureString, X509KeyStorageFlags)

Inicializa una nueva instancia de la clase X509Certificate2 utilizando una matriz de bytes, una contraseña y una marca de almacenamiento de claves.Initializes a new instance of the X509Certificate2 class using a byte array, a password, and a key storage flag.

X509Certificate2(Byte[], SecureString)

Inicializa una nueva instancia de la clase X509Certificate2 utilizando una matriz de bytes y una contraseña.Initializes a new instance of the X509Certificate2 class using a byte array and a password.

X509Certificate2(String)

Inicializa una nueva instancia de la clase X509Certificate2 utilizando el nombre de un archivo de certificado.Initializes a new instance of the X509Certificate2 class using a certificate file name.

X509Certificate2(X509Certificate)

Inicializa una nueva instancia de la clase X509Certificate2 mediante un objeto X509Certificate.Initializes a new instance of the X509Certificate2 class using an X509Certificate object.

X509Certificate2(IntPtr)

Inicializa una nueva instancia de la clase X509Certificate2 utilizando un identificador no administrado.Initializes a new instance of the X509Certificate2 class using an unmanaged handle.

X509Certificate2(Byte[])

Inicializa una nueva instancia de la clase X509Certificate2 utilizando información de una matriz de bytes.Initializes a new instance of the X509Certificate2 class using information from a byte array.

X509Certificate2(Byte[], String)

Inicializa una nueva instancia de la clase X509Certificate2 utilizando una matriz de bytes y una contraseña.Initializes a new instance of the X509Certificate2 class using a byte array and a password.

X509Certificate2()

Inicializa una nueva instancia de la clase X509Certificate2.Initializes a new instance of the X509Certificate2 class.

public:
 X509Certificate2();
public X509Certificate2 ();
Public Sub New ()

Ejemplos

En el ejemplo de código siguiente se abre el almacén de certificados del usuario actual, se selecciona solo certificados activos y, a continuación, se permite al usuario seleccionar uno o varios certificados.The following code example opens the current user certificate store, selects only active certificates, then allows the user to select one or more certificates. A continuación, en el ejemplo se escribe información del certificado en la consola.The example then writes certificate information to the console.

#using <System.dll>
#using <System.Security.dll>

using namespace System;
using namespace System::Security::Cryptography;
using namespace System::Security::Permissions;
using namespace System::IO;
using namespace System::Security::Cryptography::X509Certificates;
int main()
{
   try
   {
      X509Store ^ store = gcnew X509Store( "MY",StoreLocation::CurrentUser );
      store->Open( static_cast<OpenFlags>(OpenFlags::ReadOnly | OpenFlags::OpenExistingOnly) );
      X509Certificate2Collection ^ collection = dynamic_cast<X509Certificate2Collection^>(store->Certificates);
      X509Certificate2Collection ^ fcollection = dynamic_cast<X509Certificate2Collection^>(collection->Find( X509FindType::FindByTimeValid, DateTime::Now, false ));
      X509Certificate2Collection ^ scollection = X509Certificate2UI::SelectFromCollection(fcollection, "Test Certificate Select","Select a certificate from the following list to get information on that certificate",X509SelectionFlag::MultiSelection);
      Console::WriteLine( "Number of certificates: {0}{1}", scollection->Count, Environment::NewLine );
      System::Collections::IEnumerator^ myEnum = scollection->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         X509Certificate2 ^ x509 = safe_cast<X509Certificate2 ^>(myEnum->Current);
         array<Byte>^rawdata = x509->RawData;
         Console::WriteLine( "Content Type: {0}{1}", X509Certificate2::GetCertContentType( rawdata ), Environment::NewLine );
         Console::WriteLine( "Friendly Name: {0}{1}", x509->FriendlyName, Environment::NewLine );
         Console::WriteLine( "Certificate Verified?: {0}{1}", x509->Verify(), Environment::NewLine );
         Console::WriteLine( "Simple Name: {0}{1}", x509->GetNameInfo( X509NameType::SimpleName, true ), Environment::NewLine );
         Console::WriteLine( "Signature Algorithm: {0}{1}", x509->SignatureAlgorithm->FriendlyName, Environment::NewLine );
         Console::WriteLine( "Private Key: {0}{1}", x509->PrivateKey->ToXmlString( false ), Environment::NewLine );
         Console::WriteLine( "Public Key: {0}{1}", x509->PublicKey->Key->ToXmlString( false ), Environment::NewLine );
         Console::WriteLine( "Certificate Archived?: {0}{1}", x509->Archived, Environment::NewLine );
         Console::WriteLine( "Length of Raw Data: {0}{1}", x509->RawData->Length, Environment::NewLine );
         x509->Reset();
      }
      store->Close();
   }
   catch ( CryptographicException^ ) 
   {
      Console::WriteLine( "Information could not be written out for this certificate." );
   }

}

using System;
using System.Security.Cryptography;
using System.Security.Permissions;
using System.IO;
using System.Security.Cryptography.X509Certificates;

class CertSelect
{
    static void Main()
    {
        X509Store store = new X509Store("MY",StoreLocation.CurrentUser);
        store.Open(OpenFlags.ReadOnly | OpenFlags.OpenExistingOnly);

        X509Certificate2Collection collection = (X509Certificate2Collection)store.Certificates;
        X509Certificate2Collection fcollection = (X509Certificate2Collection)collection.Find(X509FindType.FindByTimeValid,DateTime.Now,false);
        X509Certificate2Collection scollection = X509Certificate2UI.SelectFromCollection(fcollection, "Test Certificate Select","Select a certificate from the following list to get information on that certificate",X509SelectionFlag.MultiSelection);
        Console.WriteLine("Number of certificates: {0}{1}",scollection.Count,Environment.NewLine);

        foreach (X509Certificate2 x509 in scollection)
        {
            try
            {
                byte[] rawdata = x509.RawData;
                Console.WriteLine("Content Type: {0}{1}",X509Certificate2.GetCertContentType(rawdata),Environment.NewLine);
                Console.WriteLine("Friendly Name: {0}{1}",x509.FriendlyName,Environment.NewLine);
                Console.WriteLine("Certificate Verified?: {0}{1}",x509.Verify(),Environment.NewLine);
                Console.WriteLine("Simple Name: {0}{1}",x509.GetNameInfo(X509NameType.SimpleName,true),Environment.NewLine);
                Console.WriteLine("Signature Algorithm: {0}{1}",x509.SignatureAlgorithm.FriendlyName,Environment.NewLine);
                Console.WriteLine("Private Key: {0}{1}",x509.PrivateKey.ToXmlString(false),Environment.NewLine);
                Console.WriteLine("Public Key: {0}{1}",x509.PublicKey.Key.ToXmlString(false),Environment.NewLine);
                Console.WriteLine("Certificate Archived?: {0}{1}",x509.Archived,Environment.NewLine);
                Console.WriteLine("Length of Raw Data: {0}{1}",x509.RawData.Length,Environment.NewLine);
                X509Certificate2UI.DisplayCertificate(x509);
                x509.Reset();
            }
            catch (CryptographicException)
            {
                Console.WriteLine("Information could not be written out for this certificate.");
            }
        }
        store.Close();
    }
}
Imports System.Security.Cryptography
Imports System.Security.Permissions
Imports System.IO
Imports System.Security.Cryptography.X509Certificates

Class CertSelect

    Shared Sub Main()

        Dim store As New X509Store("MY", StoreLocation.CurrentUser)
        store.Open(OpenFlags.ReadOnly Or OpenFlags.OpenExistingOnly)

        Dim collection As X509Certificate2Collection = CType(store.Certificates, X509Certificate2Collection)
        Dim fcollection As X509Certificate2Collection = CType(collection.Find(X509FindType.FindByTimeValid, DateTime.Now, False), X509Certificate2Collection)
        Dim scollection As X509Certificate2Collection = X509Certificate2UI.SelectFromCollection(fcollection, "Test Certificate Select", "Select a certificate from the following list to get information on that certificate", X509SelectionFlag.MultiSelection)
        Console.WriteLine("Number of certificates: {0}{1}", scollection.Count, Environment.NewLine)
         
        For Each x509 As X509Certificate2 In scollection
            Try
                Dim rawdata As Byte() = x509.RawData
                Console.WriteLine("Content Type: {0}{1}", X509Certificate2.GetCertContentType(rawdata), Environment.NewLine)
                Console.WriteLine("Friendly Name: {0}{1}", x509.FriendlyName, Environment.NewLine)
                Console.WriteLine("Certificate Verified?: {0}{1}", x509.Verify(), Environment.NewLine)
                Console.WriteLine("Simple Name: {0}{1}", x509.GetNameInfo(X509NameType.SimpleName, True), Environment.NewLine)
                Console.WriteLine("Signature Algorithm: {0}{1}", x509.SignatureAlgorithm.FriendlyName, Environment.NewLine)
                Console.WriteLine("Private Key: {0}{1}", x509.PrivateKey.ToXmlString(False), Environment.NewLine)
                Console.WriteLine("Public Key: {0}{1}", x509.PublicKey.Key.ToXmlString(False), Environment.NewLine)
                Console.WriteLine("Certificate Archived?: {0}{1}", x509.Archived, Environment.NewLine)
                Console.WriteLine("Length of Raw Data: {0}{1}", x509.RawData.Length, Environment.NewLine)
                X509Certificate2UI.DisplayCertificate(x509)
                x509.Reset()         
             Catch cExcept As CryptographicException
                 Console.WriteLine("Information could not be written out for this certificate.")
             End Try
        Next x509

        store.Close()
    End Sub
End Class

Comentarios

Este constructor crea un objeto de X509Certificate2 vacío, a diferencia de los demás constructores para esta clase que usan información de certificado de una matriz de bytes, un puntero o un archivo de certificado.This constructor creates an empty X509Certificate2 object, unlike the other constructors for this class that use certificate information from a byte array, a pointer, or a certificate file.

X509Certificate2(String, String, X509KeyStorageFlags)

Inicializa una nueva instancia de la clase X509Certificate2 utilizando el nombre de un archivo de certificado, una contraseña para obtener acceso al certificado y una marca de almacenamiento claves.Initializes a new instance of the X509Certificate2 class using a certificate file name, a password used to access the certificate, and a key storage flag.

public:
 X509Certificate2(System::String ^ fileName, System::String ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);
public X509Certificate2 (string fileName, string password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
new System.Security.Cryptography.X509Certificates.X509Certificate2 : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate2
Public Sub New (fileName As String, password As String, keyStorageFlags As X509KeyStorageFlags)

Parámetros

fileName
String

Nombre de un archivo de certificado.The name of a certificate file.

password
String

Contraseña requerida para obtener acceso a los datos del certificado X.509.The password required to access the X.509 certificate data.

keyStorageFlags
X509KeyStorageFlags

Combinación bit a bit de los valores de enumeración que controlan dónde y cómo importar el certificado.A bitwise combination of the enumeration values that control where and how to import the certificate.

Excepciones

Se genera un error con el certificado.An error with the certificate occurs. Por ejemplo:For example:

- El archivo de certificado no existe.- The certificate file does not exist.

- El certificado no es válido.- The certificate is invalid.

- La contraseña del certificado es incorrecta.- The certificate's password is incorrect.

Comentarios

Este constructor crea un nuevo objeto X509Certificate2 con un nombre de archivo de certificado, una contraseña necesaria para obtener acceso al certificado y una marca de almacenamiento de claves.This constructor creates a new X509Certificate2 object using a certificate file name, a password needed to access the certificate, and a key storage flag.

Importante

No codifique nunca una contraseña dentro del código fuente.Never hard code a password within your source code. Las contraseñas codificadas de forma rígida se pueden recuperar de un ensamblado mediante Ildasm. exe (desensamblador de IL), un editor hexadecimal o simplemente abriendo el ensamblado en un editor de texto, como Notepad. exe.Hard-coded passwords can be retrieved from an assembly using the Ildasm.exe (IL Disassembler), a hex editor, or by simply opening up the assembly in a text editor such as Notepad.exe.

Si crea un certificado de X509Certificate2 mediante la especificación de un almacén de archivos firmados con el estándar PKCS7 para fileName, el X509Certificate2 se crea para el certificado que firmó el almacén en lugar de para cualquiera de los certificados del almacén.If you create an X509Certificate2 certificate by specifying a PKCS7 signed file store for fileName, the X509Certificate2 is created for the certificate that signed the store rather than for any of the certificates within the store.

Seguridad

SecurityPermission
para tener acceso a código no administrado.for accessing unmanaged code. Acción de seguridad: InheritanceDemand.Security action: InheritanceDemand. Enumeración asociada: UnmanagedCodeAssociated enumeration: UnmanagedCode

X509Certificate2(String, SecureString, X509KeyStorageFlags)

Importante

Esta API no es conforme a CLS.

Inicializa una nueva instancia de la clase X509Certificate2 utilizando el nombre de un archivo de certificado, una contraseña y una marca de almacenamiento de claves.Initializes a new instance of the X509Certificate2 class using a certificate file name, a password, and a key storage flag.

public:
 X509Certificate2(System::String ^ fileName, System::Security::SecureString ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
public X509Certificate2 (string fileName, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
new System.Security.Cryptography.X509Certificates.X509Certificate2 : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate2
Public Sub New (fileName As String, password As SecureString, keyStorageFlags As X509KeyStorageFlags)

Parámetros

fileName
String

Nombre de un archivo de certificado.The name of a certificate file.

password
SecureString

Contraseña requerida para obtener acceso a los datos del certificado X.509.The password required to access the X.509 certificate data.

keyStorageFlags
X509KeyStorageFlags

Combinación bit a bit de los valores de enumeración que controlan dónde y cómo importar el certificado.A bitwise combination of the enumeration values that control where and how to import the certificate.

Atributos

Excepciones

Se genera un error con el certificado.An error with the certificate occurs. Por ejemplo:For example:

- El archivo de certificado no existe.- The certificate file does not exist.

- El certificado no es válido.- The certificate is invalid.

- La contraseña del certificado es incorrecta.- The certificate's password is incorrect.

Comentarios

Si crea un certificado de X509Certificate mediante la especificación de un almacén de archivos firmados con el estándar PKCS7 para fileName, el X509Certificate se crea para el certificado que firmó el almacén en lugar de para cualquiera de los certificados del almacén.If you create an X509Certificate certificate by specifying a PKCS7 signed file store for fileName, the X509Certificate is created for the certificate that signed the store rather than for any of the certificates within the store.

Seguridad

SecurityPermission
para tener acceso a código no administrado.for accessing unmanaged code. Acción de seguridad: InheritanceDemand.Security action: InheritanceDemand. Enumeración asociada: UnmanagedCodeAssociated enumeration: UnmanagedCode

X509Certificate2(Byte[], String, X509KeyStorageFlags)

Inicializa una nueva instancia de la clase X509Certificate2 utilizando una matriz de bytes, una contraseña y una marca de almacenamiento de claves.Initializes a new instance of the X509Certificate2 class using a byte array, a password, and a key storage flag.

public:
 X509Certificate2(cli::array <System::Byte> ^ rawData, System::String ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);
public X509Certificate2 (byte[] rawData, string password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
new System.Security.Cryptography.X509Certificates.X509Certificate2 : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate2
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.A byte array containing data from an X.509 certificate.

password
String

Contraseña requerida para obtener acceso a los datos del certificado X.509.The password required to access the X.509 certificate data.

keyStorageFlags
X509KeyStorageFlags

Combinación bit a bit de los valores de enumeración que controlan dónde y cómo importar el certificado.A bitwise combination of the enumeration values that control where and how to import the certificate.

Excepciones

Se genera un error con el certificado.An error with the certificate occurs. Por ejemplo:For example:

- El archivo de certificado no existe.- The certificate file does not exist.

- El certificado no es válido.- The certificate is invalid.

- La contraseña del certificado es incorrecta.- The certificate's password is incorrect.

Comentarios

Este constructor crea un nuevo objeto X509Certificate2 mediante una matriz de bytes, una contraseña que se necesita para tener acceso a los datos del certificado y una marca de almacenamiento de claves.This constructor creates a new X509Certificate2 object using a byte array, a password that is needed to access the certificate data, and a key storage flag. Se usa con archivos PKCS12 (PFX) que contienen la clave privada del certificado.It is used with PKCS12 (PFX) files that contain the certificate's private key. Si se llama 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.Calling this constructor with the correct password decrypts the private key and saves it to a Microsoft Cryptographic API Cryptographic Service Provider (CSP).

Importante

No codifique nunca una contraseña dentro del código fuente.Never hard code a password within your source code. Las contraseñas codificadas de forma rígida se pueden recuperar de un ensamblado mediante Ildasm. exe (desensamblador de IL), un editor hexadecimal o simplemente abriendo el ensamblado en un editor de texto, como Notepad. exe.Hard-coded passwords can be retrieved from an assembly using the Ildasm.exe (IL Disassembler), a hex editor, or by simply opening up the assembly in a text editor such as Notepad.exe.

Si crea un certificado de X509Certificate2 mediante la especificación de un almacén de archivos firmados con el estándar PKCS7 para rawData, el X509Certificate2 se crea para el certificado que firmó el almacén en lugar de para cualquiera de los certificados del almacén.If you create an X509Certificate2 certificate by specifying a PKCS7 signed file store for rawData, the X509Certificate2 is created for the certificate that signed the store rather than for any of the certificates within the store.

Seguridad

SecurityPermission
para tener acceso a código no administrado.for accessing unmanaged code. Acción de seguridad: InheritanceDemand.Security action: InheritanceDemand. Enumeración asociada: UnmanagedCodeAssociated enumeration: UnmanagedCode

X509Certificate2(String, String)

Inicializa una nueva instancia de la clase X509Certificate2 utilizando el nombre de un archivo de certificado y una contraseña para obtener acceso al certificado.Initializes a new instance of the X509Certificate2 class using a certificate file name and a password used to access the certificate.

public:
 X509Certificate2(System::String ^ fileName, System::String ^ password);
public X509Certificate2 (string fileName, string password);
new System.Security.Cryptography.X509Certificates.X509Certificate2 : string * string -> System.Security.Cryptography.X509Certificates.X509Certificate2
Public Sub New (fileName As String, password As String)

Parámetros

fileName
String

Nombre de un archivo de certificado.The name of a certificate file.

password
String

Contraseña requerida para obtener acceso a los datos del certificado X.509.The password required to access the X.509 certificate data.

Excepciones

Se genera un error con el certificado.An error with the certificate occurs. Por ejemplo:For example:

- El archivo de certificado no existe.- The certificate file does not exist.

- El certificado no es válido.- The certificate is invalid.

- La contraseña del certificado es incorrecta.- The certificate's password is incorrect.

Comentarios

Este constructor crea un nuevo objeto X509Certificate2 con un nombre de archivo de certificado y una contraseña necesaria para obtener acceso al certificado.This constructor creates a new X509Certificate2 object using a certificate file name and a password needed to access the certificate. Se usa con archivos PKCS12 (PFX) que contienen la clave privada del certificado.It is used with PKCS12 (PFX) files that contain the certificate's private key. Al llamar a este constructor con la contraseña correcta, se descifra la clave privada y se guarda en un contenedor de claves.Calling this constructor with the correct password decrypts the private key and saves it to a key container.

Importante

No codifique nunca una contraseña dentro del código fuente.Never hard code a password within your source code. Las contraseñas codificadas de forma rígida se pueden recuperar de un ensamblado mediante Ildasm. exe (desensamblador de IL), un editor hexadecimal o simplemente abriendo el ensamblado en un editor de texto, como Notepad. exe.Hard-coded passwords can be retrieved from an assembly using the Ildasm.exe (IL Disassembler), a hex editor, or by simply opening up the assembly in a text editor such as Notepad.exe.

Si crea un certificado de X509Certificate2 mediante la especificación de un almacén de archivos firmados con el estándar PKCS7 para fileName, el X509Certificate2 se crea para el certificado que firmó el almacén en lugar de para cualquiera de los certificados del almacén.If you create an X509Certificate2 certificate by specifying a PKCS7 signed file store for fileName, the X509Certificate2 is created for the certificate that signed the store rather than for any of the certificates within the store.

Seguridad

SecurityPermission
para tener acceso a código no administrado.for accessing unmanaged code. Acción de seguridad: InheritanceDemand.Security action: InheritanceDemand. Enumeración asociada: UnmanagedCodeAssociated enumeration: UnmanagedCode

X509Certificate2(String, SecureString)

Importante

Esta API no es conforme a CLS.

Inicializa una nueva instancia de la clase X509Certificate2 utilizando el nombre de un archivo de certificado y una contraseña.Initializes a new instance of the X509Certificate2 class using a certificate file name and a password.

public:
 X509Certificate2(System::String ^ fileName, System::Security::SecureString ^ password);
[System.CLSCompliant(false)]
public X509Certificate2 (string fileName, System.Security.SecureString password);
new System.Security.Cryptography.X509Certificates.X509Certificate2 : string * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate2
Public Sub New (fileName As String, password As SecureString)

Parámetros

fileName
String

Nombre de un archivo de certificado.The name of a certificate file.

password
SecureString

Contraseña requerida para obtener acceso a los datos del certificado X.509.The password required to access the X.509 certificate data.

Atributos

Excepciones

Se genera un error con el certificado.An error with the certificate occurs. Por ejemplo:For example:

- El archivo de certificado no existe.- The certificate file does not exist.

- El certificado no es válido.- The certificate is invalid.

- La contraseña del certificado es incorrecta.- The certificate's password is incorrect.

Comentarios

Este constructor se usa con archivos PKCS12 (PFX) que contienen la clave privada del certificado.This constructor is used with PKCS12 (PFX) files that contain the certificate's private key. Al llamar a este constructor con la contraseña correcta, se descifra la clave privada y se guarda en un contenedor de claves.Calling this constructor with the correct password decrypts the private key and saves it to a key container.

Importante

No codifique nunca una contraseña dentro del código fuente.Never hard code a password within your source code. Las contraseñas codificadas de forma rígida se pueden recuperar de un ensamblado mediante Ildasm. exe (desensamblador de IL), un editor hexadecimal o simplemente abriendo el ensamblado en un editor de texto, como Notepad. exe.Hard-coded passwords can be retrieved from an assembly using the Ildasm.exe (IL Disassembler), a hex editor, or by simply opening up the assembly in a text editor such as Notepad.exe.

Si crea un certificado de X509Certificate mediante la especificación de un almacén de archivos firmados con el estándar PKCS7 para fileName, el X509Certificate se crea para el certificado que firmó el almacén en lugar de para cualquiera de los certificados del almacén.If you create an X509Certificate certificate by specifying a PKCS7 signed file store for fileName, the X509Certificate is created for the certificate that signed the store rather than for any of the certificates within the store.

Seguridad

SecurityPermission
para tener acceso a código no administrado.for accessing unmanaged code. Acción de seguridad: InheritanceDemand.Security action: InheritanceDemand. Enumeración asociada: UnmanagedCodeAssociated enumeration: UnmanagedCode

X509Certificate2(SerializationInfo, StreamingContext)

Inicializa una nueva instancia de la clase X509Certificate2 utilizando la información de serialización y el contexto de secuencia especificados.Initializes a new instance of the X509Certificate2 class using the specified serialization and stream context information.

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

Parámetros

info
SerializationInfo

Información de serialización necesaria para deserializar la nueva clase X509Certificate2.The serialization information required to deserialize the new X509Certificate2.

context
StreamingContext

Información contextual sobre el origen de la secuencia que se va a deserializar.Contextual information about the source of the stream to be deserialized.

Excepciones

Solo .NET Core: En todos los casos..NET Core only: In all cases.

Seguridad

SecurityPermission
para tener acceso a código no administrado.for accessing unmanaged code. Acción de seguridad: InheritanceDemand.Security action: InheritanceDemand. Enumeración asociada: UnmanagedCodeAssociated enumeration: UnmanagedCode

X509Certificate2(Byte[], SecureString, X509KeyStorageFlags)

Importante

Esta API no es conforme a CLS.

Inicializa una nueva instancia de la clase X509Certificate2 utilizando una matriz de bytes, una contraseña y una marca de almacenamiento de claves.Initializes a new instance of the X509Certificate2 class using a byte array, a password, and a key storage flag.

public:
 X509Certificate2(cli::array <System::Byte> ^ rawData, System::Security::SecureString ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
public X509Certificate2 (byte[] rawData, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
new System.Security.Cryptography.X509Certificates.X509Certificate2 : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate2
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.A byte array that contains data from an X.509 certificate.

password
SecureString

Contraseña requerida para obtener acceso a los datos del certificado X.509.The password required to access the X.509 certificate data.

keyStorageFlags
X509KeyStorageFlags

Combinación bit a bit de los valores de enumeración que controlan dónde y cómo importar el certificado.A bitwise combination of the enumeration values that control where and how to import the certificate.

Atributos

Excepciones

Se genera un error con el certificado.An error with the certificate occurs. Por ejemplo:For example:

- El archivo de certificado no existe.- The certificate file does not exist.

- El certificado no es válido.- The certificate is invalid.

- La contraseña del certificado es incorrecta.- The certificate's password is incorrect.

Comentarios

Este constructor se usa con archivos PKCS12 (PFX) que contienen la clave privada del certificado.This constructor is used with PKCS12 (PFX) files that contain the certificate's private key. Si se llama 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.Calling this constructor with the correct password decrypts the private key and saves it to a Microsoft Cryptographic API Cryptographic Service Provider (CSP).

Importante

No codifique nunca una contraseña dentro del código fuente.Never hard code a password within your source code. Las contraseñas codificadas de forma rígida se pueden recuperar de un ensamblado mediante Ildasm. exe (desensamblador de IL), un editor hexadecimal o simplemente abriendo el ensamblado en un editor de texto, como Notepad. exe.Hard-coded passwords can be retrieved from an assembly using the Ildasm.exe (IL Disassembler), a hex editor, or by simply opening up the assembly in a text editor such as Notepad.exe.

Si crea un certificado de X509Certificate mediante la especificación de un almacén de archivos firmados con el estándar PKCS7 para rawData, el X509Certificate se crea para el certificado que firmó el almacén en lugar de para cualquiera de los certificados del almacén.If you create an X509Certificate certificate by specifying a PKCS7 signed file store for rawData, the X509Certificate is created for the certificate that signed the store rather than for any of the certificates within the store.

Seguridad

SecurityPermission
para tener acceso a código no administrado.for accessing unmanaged code. Acción de seguridad: InheritanceDemand.Security action: InheritanceDemand. Enumeración asociada: UnmanagedCodeAssociated enumeration: UnmanagedCode

X509Certificate2(Byte[], SecureString)

Importante

Esta API no es conforme a CLS.

Inicializa una nueva instancia de la clase X509Certificate2 utilizando una matriz de bytes y una contraseña.Initializes a new instance of the X509Certificate2 class using a byte array and a password.

public:
 X509Certificate2(cli::array <System::Byte> ^ rawData, System::Security::SecureString ^ password);
[System.CLSCompliant(false)]
public X509Certificate2 (byte[] rawData, System.Security.SecureString password);
new System.Security.Cryptography.X509Certificates.X509Certificate2 : byte[] * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate2
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.A byte array that contains data from an X.509 certificate.

password
SecureString

Contraseña requerida para obtener acceso a los datos del certificado X.509.The password required to access the X.509 certificate data.

Atributos

Excepciones

Se genera un error con el certificado.An error with the certificate occurs. Por ejemplo:For example:

- El archivo de certificado no existe.- The certificate file does not exist.

- El certificado no es válido.- The certificate is invalid.

- La contraseña del certificado es incorrecta.- The certificate's password is incorrect.

Comentarios

Este constructor se usa con archivos PKCS12 (PFX) que contienen la clave privada del certificado.This constructor is used with PKCS12 (PFX) files that contain the certificate's private key. Al llamar a este constructor con la contraseña correcta, se descifra la clave privada y se guarda en un contenedor de claves.Calling this constructor with the correct password decrypts the private key and saves it to a key container.

Importante

No codifique nunca una contraseña dentro del código fuente.Never hard code a password within your source code. Las contraseñas codificadas de forma rígida se pueden recuperar de un ensamblado mediante Ildasm. exe (desensamblador de IL), un editor hexadecimal o simplemente abriendo el ensamblado en un editor de texto, como Notepad. exe.Hard-coded passwords can be retrieved from an assembly using the Ildasm.exe (IL Disassembler), a hex editor, or by simply opening up the assembly in a text editor such as Notepad.exe.

Si crea un certificado de X509Certificate mediante la especificación de un almacén de archivos firmados con el estándar PKCS7 para rawData, el X509Certificate se crea para el certificado que firmó el almacén en lugar de para cualquiera de los certificados del almacén.If you create an X509Certificate certificate by specifying a PKCS7 signed file store for rawData, the X509Certificate is created for the certificate that signed the store rather than for any of the certificates within the store.

Seguridad

SecurityPermission
para tener acceso a código no administrado.for accessing unmanaged code. Acción de seguridad: InheritanceDemand.Security action: InheritanceDemand. Enumeración asociada: UnmanagedCodeAssociated enumeration: UnmanagedCode

X509Certificate2(String)

Inicializa una nueva instancia de la clase X509Certificate2 utilizando el nombre de un archivo de certificado.Initializes a new instance of the X509Certificate2 class using a certificate file name.

public:
 X509Certificate2(System::String ^ fileName);
public X509Certificate2 (string fileName);
new System.Security.Cryptography.X509Certificates.X509Certificate2 : string -> System.Security.Cryptography.X509Certificates.X509Certificate2
Public Sub New (fileName As String)

Parámetros

fileName
String

Nombre de un archivo de certificado.The name of a certificate file.

Excepciones

Se genera un error con el certificado.An error with the certificate occurs. Por ejemplo:For example:

- El archivo de certificado no existe.- The certificate file does not exist.

- El certificado no es válido.- The certificate is invalid.

- La contraseña del certificado es incorrecta.- The certificate's password is incorrect.

Comentarios

Este constructor crea un nuevo objeto X509Certificate2 con un nombre de archivo de certificado.This constructor creates a new X509Certificate2 object using a certificate file name. Admite la codificación binaria (DER) o la codificación Base64.It supports binary (DER) encoding or Base64 encoding.

Si crea un certificado de X509Certificate2 mediante la especificación de un almacén de archivos firmados con el estándar PKCS7 para fileName, el X509Certificate2 se crea para el certificado que firmó el almacén en lugar de para cualquiera de los certificados del almacén.If you create an X509Certificate2 certificate by specifying a PKCS7 signed file store for fileName, the X509Certificate2 is created for the certificate that signed the store rather than for any of the certificates within the store.

X509Certificate2(X509Certificate)

Inicializa una nueva instancia de la clase X509Certificate2 mediante un objeto X509Certificate.Initializes a new instance of the X509Certificate2 class using an X509Certificate object.

public:
 X509Certificate2(System::Security::Cryptography::X509Certificates::X509Certificate ^ certificate);
public X509Certificate2 (System.Security.Cryptography.X509Certificates.X509Certificate certificate);
new System.Security.Cryptography.X509Certificates.X509Certificate2 : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Security.Cryptography.X509Certificates.X509Certificate2
Public Sub New (certificate As X509Certificate)

Parámetros

certificate
X509Certificate

Un objeto X509Certificate.An X509Certificate object.

Excepciones

Se genera un error con el certificado.An error with the certificate occurs. Por ejemplo:For example:

- El archivo de certificado no existe.- The certificate file does not exist.

- El certificado no es válido.- The certificate is invalid.

- La contraseña del certificado es incorrecta.- The certificate's password is incorrect.

Comentarios

Este método crea una nueva instancia de la clase X509Certificate2 mediante un objeto X509Certificate.This method creates a new instance of the X509Certificate2 class using an X509Certificate object.

Seguridad

SecurityPermission
para tener acceso a código no administrado.for accessing unmanaged code. Acción de seguridad: InheritanceDemand.Security action: InheritanceDemand. Enumeración asociada: UnmanagedCodeAssociated enumeration: UnmanagedCode

X509Certificate2(IntPtr)

Inicializa una nueva instancia de la clase X509Certificate2 utilizando un identificador no administrado.Initializes a new instance of the X509Certificate2 class using an unmanaged handle.

public:
 X509Certificate2(IntPtr handle);
public X509Certificate2 (IntPtr handle);
new System.Security.Cryptography.X509Certificates.X509Certificate2 : nativeint -> System.Security.Cryptography.X509Certificates.X509Certificate2
Public Sub New (handle As IntPtr)

Parámetros

handle
IntPtr

Puntero a un contexto de certificado en código no administrado.A pointer to a certificate context in unmanaged code. La estructura C se llama PCCERT_CONTEXT.The C structure is called PCCERT_CONTEXT.

Excepciones

Se genera un error con el certificado.An error with the certificate occurs. Por ejemplo:For example:

- El archivo de certificado no existe.- The certificate file does not exist.

- El certificado no es válido.- The certificate is invalid.

- La contraseña del certificado es incorrecta.- The certificate's password is incorrect.

Comentarios

Este constructor crea un nuevo objeto X509Certificate2 con un identificador para el contexto de certificado de la API criptográfica de Microsoft, PCCERT_CONTEXT.This constructor creates a new X509Certificate2 object using a handle for the Microsoft Cryptographic API certificate context, PCCERT_CONTEXT. Tenga en cuenta que el llamador inmediato de este constructor requiere permiso de código no administrado.Note that the immediate caller of this constructor requires unmanaged code permission.

Importante

El constructor crea una copia del contexto del certificado.The constructor creates a copy of the certificate context. No suponga que la estructura de contexto que ha pasado al constructor es válida; es posible que se haya lanzado.Do not assume that the context structure you passed to the constructor is valid; it may have been released. Puede obtener una copia de la estructura de PCCERT_CONTEXT actual de la propiedad Handle, pero solo es válido durante la duración del objeto X509Certificate2.You can get a copy of the current PCCERT_CONTEXT structure from the Handle property, but it is valid only during the lifetime of the X509Certificate2 object.

Seguridad

SecurityPermission
para tener acceso a código no administrado.for accessing unmanaged code. Acción de seguridad: InheritanceDemand.Security action: InheritanceDemand. Enumeración asociada: UnmanagedCodeAssociated enumeration: UnmanagedCode

X509Certificate2(Byte[])

Inicializa una nueva instancia de la clase X509Certificate2 utilizando información de una matriz de bytes.Initializes a new instance of the X509Certificate2 class using information from a byte array.

public:
 X509Certificate2(cli::array <System::Byte> ^ rawData);
public X509Certificate2 (byte[] rawData);
new System.Security.Cryptography.X509Certificates.X509Certificate2 : byte[] -> System.Security.Cryptography.X509Certificates.X509Certificate2
Public Sub New (rawData As Byte())

Parámetros

rawData
Byte[]

Matriz de bytes que contiene los datos de un certificado X.509.A byte array containing data from an X.509 certificate.

Excepciones

Se genera un error con el certificado.An error with the certificate occurs. Por ejemplo:For example:

- El archivo de certificado no existe.- The certificate file does not exist.

- El certificado no es válido.- The certificate is invalid.

- La contraseña del certificado es incorrecta.- The certificate's password is incorrect.

Comentarios

Este constructor crea un nuevo objeto X509Certificate2 con la información de certificado de una matriz de bytes.This constructor creates a new X509Certificate2 object using certificate information from a byte array. La matriz de bytes puede ser binaria (DER) codificada o datos X. 509 codificados en Base64.The byte array can be binary (DER) encoded or Base64-encoded X.509 data. La matriz de bytes también puede ser un archivo firmado con el estándar PKCS7 (Authenticode); el certificado del firmante se usa para crear el objeto.The byte array can also be a PKCS7 (Authenticode) signed file; the signer certificate is used to create the object.

Si crea un certificado de X509Certificate2 mediante la especificación de un almacén de archivos firmados con el estándar PKCS7 para rawData, el X509Certificate2 se crea para el certificado que firmó el almacén en lugar de para cualquiera de los certificados del almacén.If you create an X509Certificate2 certificate by specifying a PKCS7 signed file store for rawData, the X509Certificate2 is created for the certificate that signed the store rather than for any of the certificates within the store.

X509Certificate2(Byte[], String)

Inicializa una nueva instancia de la clase X509Certificate2 utilizando una matriz de bytes y una contraseña.Initializes a new instance of the X509Certificate2 class using a byte array and a password.

public:
 X509Certificate2(cli::array <System::Byte> ^ rawData, System::String ^ password);
public X509Certificate2 (byte[] rawData, string password);
new System.Security.Cryptography.X509Certificates.X509Certificate2 : byte[] * string -> System.Security.Cryptography.X509Certificates.X509Certificate2
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.A byte array containing data from an X.509 certificate.

password
String

Contraseña requerida para obtener acceso a los datos del certificado X.509.The password required to access the X.509 certificate data.

Excepciones

Se genera un error con el certificado.An error with the certificate occurs. Por ejemplo:For example:

- El archivo de certificado no existe.- The certificate file does not exist.

- El certificado no es válido.- The certificate is invalid.

- La contraseña del certificado es incorrecta.- The certificate's password is incorrect.

Comentarios

Este constructor crea un nuevo objeto X509Certificate2 mediante una matriz de bytes y una contraseña que se necesitan para tener acceso a los datos del certificado.This constructor creates a new X509Certificate2 object using a byte array and a password that is needed to access the certificate data. Se usa con archivos PKCS12 (PFX) que contienen la clave privada del certificado.It is used with PKCS12 (PFX) files that contain the certificate's private key. Al llamar a este constructor con la contraseña correcta, se descifra la clave privada y se guarda en un contenedor de claves.Calling this constructor with the correct password decrypts the private key and saves it to a key container.

Importante

No codifique nunca una contraseña dentro del código fuente.Never hard code a password within your source code. Las contraseñas codificadas de forma rígida se pueden recuperar de un ensamblado mediante Ildasm. exe (desensamblador de IL), un editor hexadecimal o simplemente abriendo el ensamblado en un editor de texto, como Notepad. exe.Hard-coded passwords can be retrieved from an assembly using the Ildasm.exe (IL Disassembler), a hex editor, or by simply opening up the assembly in a text editor such as Notepad.exe.

Si crea un certificado de X509Certificate2 mediante la especificación de un almacén de archivos firmados con el estándar PKCS7 para rawData, el X509Certificate2 se crea para el certificado que firmó el almacén en lugar de para cualquiera de los certificados del almacén.If you create an X509Certificate2 certificate by specifying a PKCS7 signed file store for rawData, the X509Certificate2 is created for the certificate that signed the store rather than for any of the certificates within the store.

Seguridad

SecurityPermission
para tener acceso a código no administrado.for accessing unmanaged code. Acción de seguridad: InheritanceDemand.Security action: InheritanceDemand. Enumeración asociada: UnmanagedCodeAssociated enumeration: UnmanagedCode

Se aplica a