X509Certificate.Export Método

Definición

Exporta el objeto X509Certificate actual a una matriz de bytes.Exports the current X509Certificate object to a byte array.

Sobrecargas

Export(X509ContentType)

Exporta el objeto X509Certificate actual a una matriz de bytes en un formato descrito por uno de los valores de X509ContentType.Exports the current X509Certificate object to a byte array in a format described by one of the X509ContentType values.

Export(X509ContentType, SecureString)

Exporta el objeto X509Certificate actual a una matriz de bytes utilizando el formato especificado y una contraseña.Exports the current X509Certificate object to a byte array using the specified format and a password.

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.Exports the current X509Certificate object to a byte array in a format described by one of the X509ContentType values, and using the specified password.

Export(X509ContentType)

Exporta el objeto X509Certificate actual a una matriz de bytes en un formato descrito por uno de los valores de X509ContentType.Exports the current X509Certificate object to a byte array in a format described by one of the X509ContentType values.

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.One of the X509ContentType values that describes how to format the output data.

Devoluciones

Byte[]

Matriz de bytes que representa el objeto X509Certificate actual.An array of bytes that represents the current X509Certificate object.

Atributos

Excepciones

Se ha pasado al parámetro contentType un valor distinto de Cert, SerializedCert o Pkcs12.A value other than Cert, SerializedCert, or Pkcs12 was passed to the contentType parameter.

O bien-or- No se puede exportar el certificado.The certificate could not be exported.

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.The following example loads an X.509 certificate file into an X509Certificate object, exports the certificate as a byte array, and then imports the byte array into another X509Certificate object.

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 solo acepta los siguientes valores de la X509ContentType enumeración: Cert , SerializedCert y Pkcs12 .The contentType parameter accepts only the following values of the X509ContentType enumeration: Cert, SerializedCert, and Pkcs12. Al pasar cualquier otro valor, CryptographicException se produce una excepción.Passing any other value causes a CryptographicException to be thrown.

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.Exports the current X509Certificate object to a byte array using the specified format and a password.

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.One of the X509ContentType values that describes how to format the output data.

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.

Devoluciones

Byte[]

Matriz de bytes que representa el objeto X509Certificate actual.A byte array that represents the current X509Certificate object.

Atributos

Excepciones

Se ha pasado al parámetro contentType un valor distinto de Cert, SerializedCert o Pkcs12.A value other than Cert, SerializedCert, or Pkcs12 was passed to the contentType parameter.

O bien-or- No se puede exportar el certificado.The certificate could not be exported.

Comentarios

El contentType parámetro solo acepta los siguientes valores de la X509ContentType enumeración: Cert , SerializedCert y Pkcs12 .The contentType parameter accepts only the following values of the X509ContentType enumeration: Cert, SerializedCert, and Pkcs12. Al pasar cualquier otro valor, CryptographicException se produce una excepción.Passing any other value causes a CryptographicException to be thrown.

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 el 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 the assembly in a text editor such as 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.Exports the current X509Certificate object to a byte array in a format described by one of the X509ContentType values, and using the specified password.

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.One of the X509ContentType values that describes how to format the output data.

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.

Devoluciones

Byte[]

Matriz de bytes que representa el objeto X509Certificate actual.An array of bytes that represents the current X509Certificate object.

Atributos

Excepciones

Se ha pasado al parámetro contentType un valor distinto de Cert, SerializedCert o Pkcs12.A value other than Cert, SerializedCert, or Pkcs12 was passed to the contentType parameter.

O bien-or- No se puede exportar el certificado.The certificate could not be exported.

Comentarios

El contentType parámetro solo acepta los siguientes valores de la X509ContentType enumeración: Cert , SerializedCert y Pkcs12 .The contentType parameter accepts only the following values of the X509ContentType enumeration: Cert, SerializedCert, and Pkcs12. Al pasar cualquier otro valor, CryptographicException se produce una excepción.Passing any other value causes a CryptographicException to be thrown.

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 el 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 the assembly in a text editor such as Notepad.exe.

Se aplica a