X509Certificate.Export Método

Referencia

Definición

Espacio de nombres:: System.Security.Cryptography.X509Certificates

Ensamblado:: System.Security.Cryptography.X509Certificates.dll

Ensamblado:: System.Security.Cryptography.dll

Ensamblado:: mscorlib.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Exporta el objeto X509Certificate actual a una matriz de bytes.

Sobrecargas

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

Export(X509ContentType)

Exporta el objeto X509Certificate actual a una matriz de bytes en un formato descrito por uno de los valores de X509ContentType.

public:
 virtual cli::array <System::Byte> ^ Export(System::Security::Cryptography::X509Certificates::X509ContentType contentType);

public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType);

[System.Runtime.InteropServices.ComVisible(false)]
public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType);

abstract member Export : System.Security.Cryptography.X509Certificates.X509ContentType -> byte[]
override this.Export : System.Security.Cryptography.X509Certificates.X509ContentType -> byte[]

[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member Export : System.Security.Cryptography.X509Certificates.X509ContentType -> byte[]
override this.Export : System.Security.Cryptography.X509Certificates.X509ContentType -> byte[]

Public Overridable Function Export (contentType As X509ContentType) As Byte()

Parámetros

contentType: X509ContentType

Uno de los valores de X509ContentType que describe cómo dar formato a los datos de salida.

Devoluciones

Byte[]

Matriz de bytes que representa el objeto X509Certificate actual.

Atributos: ComVisibleAttribute

Excepciones

CryptographicException

Se ha pasado al parámetro contentType un valor distinto de Cert, SerializedCert o Pkcs12.

O bien No se puede exportar el certificado.

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

El contentType parámetro acepta solo los siguientes valores de la X509ContentType enumeración: Cert, SerializedCerty Pkcs12. Pasar cualquier otro valor hace que se produzca una CryptographicException excepción .

Se aplica a

Export(X509ContentType, SecureString)

Importante

Esta API no es conforme a CLS.

Exporta el objeto X509Certificate actual a una matriz de bytes utilizando el formato especificado y una contraseña.

public:
 virtual cli::array <System::Byte> ^ Export(System::Security::Cryptography::X509Certificates::X509ContentType contentType, System::Security::SecureString ^ password);

[System.CLSCompliant(false)]
public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType, System.Security.SecureString? password);

[System.CLSCompliant(false)]
public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType, System.Security.SecureString password);

public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType, System.Security.SecureString password);

[<System.CLSCompliant(false)>]
abstract member Export : System.Security.Cryptography.X509Certificates.X509ContentType * System.Security.SecureString -> byte[]
override this.Export : System.Security.Cryptography.X509Certificates.X509ContentType * System.Security.SecureString -> byte[]

abstract member Export : System.Security.Cryptography.X509Certificates.X509ContentType * System.Security.SecureString -> byte[]
override this.Export : System.Security.Cryptography.X509Certificates.X509ContentType * System.Security.SecureString -> byte[]

Public Overridable Function Export (contentType As X509ContentType, password As SecureString) As Byte()

Parámetros

contentType: X509ContentType

Uno de los valores de X509ContentType que describe cómo dar formato a los datos de salida.

password: SecureString

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

Devoluciones

Byte[]

Matriz de bytes que representa el objeto X509Certificate actual.

Atributos: CLSCompliantAttribute

Excepciones

CryptographicException

Se ha pasado al parámetro contentType un valor distinto de Cert, SerializedCert o Pkcs12.

O bien No se puede exportar el certificado.

Comentarios

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.

Se aplica a

Export(X509ContentType, String)

Exporta el objeto X509Certificate actual a una matriz de bytes en un formato descrito por uno de los valores de X509ContentType, con la contraseña especificada.

public:
 virtual cli::array <System::Byte> ^ Export(System::Security::Cryptography::X509Certificates::X509ContentType contentType, System::String ^ password);

public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType, string? password);

public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType, string password);

[System.Runtime.InteropServices.ComVisible(false)]
public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType, string password);

abstract member Export : System.Security.Cryptography.X509Certificates.X509ContentType * string -> byte[]
override this.Export : System.Security.Cryptography.X509Certificates.X509ContentType * string -> byte[]

[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member Export : System.Security.Cryptography.X509Certificates.X509ContentType * string -> byte[]
override this.Export : System.Security.Cryptography.X509Certificates.X509ContentType * string -> byte[]

Public Overridable Function Export (contentType As X509ContentType, password As String) As Byte()

Parámetros

contentType: X509ContentType

Uno de los valores de X509ContentType que describe cómo dar formato a los datos de salida.

password: String

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

Devoluciones

Byte[]

Matriz de bytes que representa el objeto X509Certificate actual.

Atributos: ComVisibleAttribute

Excepciones

CryptographicException

Se ha pasado al parámetro contentType un valor distinto de Cert, SerializedCert o Pkcs12.

O bien No se puede exportar el certificado.

Comentarios

Importante

Se aplica a

X509Certificate.Export Método

Definición

Sobrecargas

Export(X509ContentType)

Parámetros

Devoluciones

Excepciones

Ejemplos

Comentarios

Se aplica a

Export(X509ContentType, SecureString)

Parámetros

Devoluciones

Excepciones

Comentarios

Se aplica a

Export(X509ContentType, String)

Parámetros

Devoluciones

Excepciones

Comentarios

Se aplica a

Recursos adicionales