X509Certificate.Export Método

Definição

Exporta o objeto X509Certificate atual para uma matriz de bytes.Exports the current X509Certificate object to a byte array.

Sobrecargas

Export(X509ContentType)

Exporta o objeto X509Certificate atual para uma matriz de bytes em um formato descrito por um dos 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 o objeto X509Certificate atual para uma matriz de bytes usando o formato especificado e uma senha.Exports the current X509Certificate object to a byte array using the specified format and a password.

Export(X509ContentType, String)

Exporta o objeto X509Certificate atual para uma matriz de bytes em um formato descrito por um dos valores X509ContentType e com a senha 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 o objeto X509Certificate atual para uma matriz de bytes em um formato descrito por um dos 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[]
Public Overridable Function Export (contentType As X509ContentType) As Byte()

Parâmetros

contentType
X509ContentType

Um dos valores de X509ContentType que descreve como formatar os dados de saída.One of the X509ContentType values that describes how to format the output data.

Retornos

Byte[]

Uma matriz de bytes que representa o objeto X509Certificate atual.An array of bytes that represents the current X509Certificate object.

Atributos

Exceções

Um valor diferente de Cert, SerializedCert ou Pkcs12 foi passado para o parâmetrocontentType.A value other than Cert, SerializedCert, or Pkcs12 was passed to the contentType parameter.

-ou--or- Não foi possível exportar o certificado.The certificate could not be exported.

Exemplos

O exemplo a seguir carrega um arquivo de certificado X. 509 em um objeto X509Certificate, exporta o certificado como uma matriz de bytes e, em seguida, importa a matriz de bytes para outro objeto X509Certificate.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

Comentários

O parâmetro contentType aceita apenas os seguintes valores da enumeração X509ContentType: Cert, SerializedCerte Pkcs12.The contentType parameter accepts only the following values of the X509ContentType enumeration: Cert, SerializedCert, and Pkcs12. Passar qualquer outro valor faz com que uma CryptographicException seja lançada.Passing any other value causes a CryptographicException to be thrown.

Export(X509ContentType, SecureString)

Importante

Esta API não está em conformidade com CLS.

Exporta o objeto X509Certificate atual para uma matriz de bytes usando o formato especificado e uma senha.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);
public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType, System.Security.SecureString password);
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

Um dos valores de X509ContentType que descreve como formatar os dados de saída.One of the X509ContentType values that describes how to format the output data.

password
SecureString

A senha necessária para acessar os dados do certificado X.509.The password required to access the X.509 certificate data.

Retornos

Byte[]

Uma matriz de bytes que representa o objeto X509Certificate atual.A byte array that represents the current X509Certificate object.

Atributos

Exceções

Um valor diferente de Cert, SerializedCert ou Pkcs12 foi passado para o parâmetrocontentType.A value other than Cert, SerializedCert, or Pkcs12 was passed to the contentType parameter.

-ou--or- Não foi possível exportar o certificado.The certificate could not be exported.

Comentários

O parâmetro contentType aceita apenas os seguintes valores da enumeração X509ContentType: Cert, SerializedCerte Pkcs12.The contentType parameter accepts only the following values of the X509ContentType enumeration: Cert, SerializedCert, and Pkcs12. Passar qualquer outro valor faz com que uma CryptographicException seja lançada.Passing any other value causes a CryptographicException to be thrown.

Importante

Nunca codifique uma senha em seu código-fonte.Never hard code a password within your source code. As senhas embutidas em código podem ser recuperadas de um assembly usando o ILDASM. exe (desmontador de Il), um editor hexadecimal ou simplesmente abrindo o assembly em um editor de texto como o 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.

Export(X509ContentType, String)

Exporta o objeto X509Certificate atual para uma matriz de bytes em um formato descrito por um dos valores X509ContentType e com a senha 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);
[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[]
Public Overridable Function Export (contentType As X509ContentType, password As String) As Byte()

Parâmetros

contentType
X509ContentType

Um dos valores de X509ContentType que descreve como formatar os dados de saída.One of the X509ContentType values that describes how to format the output data.

password
String

A senha necessária para acessar os dados do certificado X.509.The password required to access the X.509 certificate data.

Retornos

Byte[]

Uma matriz de bytes que representa o objeto X509Certificate atual.An array of bytes that represents the current X509Certificate object.

Atributos

Exceções

Um valor diferente de Cert, SerializedCert ou Pkcs12 foi passado para o parâmetrocontentType.A value other than Cert, SerializedCert, or Pkcs12 was passed to the contentType parameter.

-ou--or- Não foi possível exportar o certificado.The certificate could not be exported.

Comentários

O parâmetro contentType aceita apenas os seguintes valores da enumeração X509ContentType: Cert, SerializedCerte Pkcs12.The contentType parameter accepts only the following values of the X509ContentType enumeration: Cert, SerializedCert, and Pkcs12. Passar qualquer outro valor faz com que uma CryptographicException seja lançada.Passing any other value causes a CryptographicException to be thrown.

Importante

Nunca codifique uma senha em seu código-fonte.Never hard code a password within your source code. As senhas embutidas em código podem ser recuperadas de um assembly usando o ILDASM. exe (desmontador de Il), um editor hexadecimal ou simplesmente abrindo o assembly em um editor de texto como o 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.

Aplica-se a