X509Certificate.Export Método

Definición

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

Ensamblados:: netstandard.dll, System.Security.Cryptography.dll

Ensamblados:: netstandard.dll, System.Security.Cryptography.X509Certificates.dll

Ensamblados:: netstandard.dll, System.Security.Cryptography.dll, System.Security.Cryptography.X509Certificates.dll

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

Ensamblado:: mscorlib.dll

Ensamblado:: netstandard.dll

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 actual X509Certificate a una matriz de bytes.

Sobrecargas

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

Export(X509ContentType)

Source:: X509Certificate.cs

Source:: X509Certificate.cs

Source:: X509Certificate.cs

Source:: X509Certificate.cs

Source:: X509Certificate.cs

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

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 X509ContentType valores que describe cómo dar formato a los datos de salida.

Devoluciones

Byte[]

Matriz de bytes que representa el objeto actual X509Certificate .

Atributos: ComVisibleAttribute

Excepciones

CryptographicException

Se pasó un valor distinto de Cert, SerializedCerto Pkcs12 al contentType parámetro .

O bien

No se pudo 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 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)

Source:: X509Certificate.cs

Source:: X509Certificate.cs

Source:: X509Certificate.cs

Source:: X509Certificate.cs

Source:: X509Certificate.cs

Importante

Esta API no es conforme a CLS.

Exporta el objeto actual X509Certificate a una matriz de bytes mediante 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 X509ContentType valores que describe cómo dar formato a los datos de salida.

password: SecureString

Contraseña necesaria para acceder a los datos del certificado X.509.

Devoluciones

Byte[]

Matriz de bytes que representa el objeto actual X509Certificate .

Atributos: CLSCompliantAttribute

Excepciones

CryptographicException

Se pasó un valor distinto de Cert, SerializedCerto Pkcs12 al contentType parámetro .

O bien

No se pudo exportar el certificado.

Comentarios

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.

Se aplica a

Export(X509ContentType, String)

Source:: X509Certificate.cs

Source:: X509Certificate.cs

Source:: X509Certificate.cs

Source:: X509Certificate.cs

Source:: X509Certificate.cs

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

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 X509ContentType valores que describe cómo dar formato a los datos de salida.

password: String

Contraseña necesaria para acceder a los datos del certificado X.509.

Devoluciones

Byte[]

Matriz de bytes que representa el objeto actual X509Certificate .

Atributos: ComVisibleAttribute

Excepciones

CryptographicException

Se pasó un valor distinto de Cert, SerializedCerto Pkcs12 al contentType parámetro .

O bien

No se pudo exportar el certificado.

Comentarios

Importante

Se aplica a

Comentarios

¿Le ha resultado útil esta página?