X509Certificate.Export Metodo

Definizione

Esporta l'oggetto X509Certificate corrente in una matrice di byte.Exports the current X509Certificate object to a byte array.

Overload

Export(X509ContentType)

Esporta l'oggetto X509Certificate corrente in una matrice di byte in un formato descritto da uno dei valori di X509ContentType.Exports the current X509Certificate object to a byte array in a format described by one of the X509ContentType values.

Export(X509ContentType, SecureString)

Esporta l'oggetto X509Certificate corrente in una matrice di byte usando il formato specificato e una password.Exports the current X509Certificate object to a byte array using the specified format and a password.

Export(X509ContentType, String)

Esporta l'oggetto X509Certificate corrente in una matrice di byte in un formato descritto da uno dei valori di X509ContentType e usando la password specificata.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)

Esporta l'oggetto X509Certificate corrente in una matrice di byte in un formato descritto da uno dei valori di 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);
[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()

Parametri

contentType
X509ContentType

Uno dei valori di X509ContentType che indica come formattare i dati di output.One of the X509ContentType values that describes how to format the output data.

Restituisce

Byte[]

Matrice di byte che rappresenta l'oggetto X509Certificate corrente.An array of bytes that represents the current X509Certificate object.

Attributi

Eccezioni

Un valore diverso da Cert, SerializedCert o Pkcs12 è stato passato al parametro contentType.A value other than Cert, SerializedCert, or Pkcs12 was passed to the contentType parameter.

-oppure--or- Non è possibile esportare il certificato.The certificate could not be exported.

Esempi

Nell'esempio seguente viene caricato un file di certificato X. 509 in un oggetto X509Certificate, viene esportato il certificato come matrice di byte e quindi viene importata la matrice di byte in un altro oggetto 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

Commenti

Il parametro contentType accetta solo i valori seguenti dell'enumerazione X509ContentType: Cert, SerializedCerte Pkcs12.The contentType parameter accepts only the following values of the X509ContentType enumeration: Cert, SerializedCert, and Pkcs12. Se si passa un altro valore, viene generata un'CryptographicException.Passing any other value causes a CryptographicException to be thrown.

Sicurezza

KeyContainerPermission
per l'autorizzazione ad aprire un contenitore di chiavi ed esportare un certificato quando si passa il valore SerializedCert al parametro contentType.for permission to open a key container and export a certificate when you pass the SerializedCert value to the contentType parameter. Azione di sicurezza: Demand.Security action: Demand. Enumerazioni associate: Open, ExportAssociated enumerations: Open, Export

Export(X509ContentType, SecureString)

Importante

Questa API non è conforme a CLS.

Esporta l'oggetto X509Certificate corrente in una matrice di byte usando il formato specificato e una password.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);
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()

Parametri

contentType
X509ContentType

Uno dei valori di X509ContentType che indica come formattare i dati di output.One of the X509ContentType values that describes how to format the output data.

password
SecureString

Password necessaria per accedere ai dati del certificato X.509.The password required to access the X.509 certificate data.

Restituisce

Byte[]

Matrice di byte che rappresenta l'oggetto X509Certificate corrente.A byte array that represents the current X509Certificate object.

Attributi

Eccezioni

Un valore diverso da Cert, SerializedCert o Pkcs12 è stato passato al parametro contentType.A value other than Cert, SerializedCert, or Pkcs12 was passed to the contentType parameter.

-oppure--or- Non è possibile esportare il certificato.The certificate could not be exported.

Commenti

Il parametro contentType accetta solo i valori seguenti dell'enumerazione X509ContentType: Cert, SerializedCerte Pkcs12.The contentType parameter accepts only the following values of the X509ContentType enumeration: Cert, SerializedCert, and Pkcs12. Se si passa un altro valore, viene generata un'CryptographicException.Passing any other value causes a CryptographicException to be thrown.

Importante

Mai codificare una password all'interno del codice sorgente.Never hard code a password within your source code. È possibile recuperare le password hardcoded da un assembly utilizzando Ildasm. exe (DISASSEMBLER il), un editor esadecimale o semplicemente aprendo l'assembly in un editor di testo, ad esempio 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.

Sicurezza

KeyContainerPermission
per l'autorizzazione ad aprire un contenitore di chiavi ed esportare un certificato quando si passa il valore SerializedCert al parametro contentType.for permission to open a key container and export a certificate when you pass the SerializedCert value to the contentType parameter. Azione di sicurezza: Demand.Security action: Demand. Enumerazioni associate: Open, ExportAssociated enumerations: Open, Export

Export(X509ContentType, String)

Esporta l'oggetto X509Certificate corrente in una matrice di byte in un formato descritto da uno dei valori di X509ContentType e usando la password specificata.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);
[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()

Parametri

contentType
X509ContentType

Uno dei valori di X509ContentType che indica come formattare i dati di output.One of the X509ContentType values that describes how to format the output data.

password
String

Password necessaria per accedere ai dati del certificato X.509.The password required to access the X.509 certificate data.

Restituisce

Byte[]

Matrice di byte che rappresenta l'oggetto X509Certificate corrente.An array of bytes that represents the current X509Certificate object.

Attributi

Eccezioni

Un valore diverso da Cert, SerializedCert o Pkcs12 è stato passato al parametro contentType.A value other than Cert, SerializedCert, or Pkcs12 was passed to the contentType parameter.

-oppure--or- Non è possibile esportare il certificato.The certificate could not be exported.

Commenti

Il parametro contentType accetta solo i valori seguenti dell'enumerazione X509ContentType: Cert, SerializedCerte Pkcs12.The contentType parameter accepts only the following values of the X509ContentType enumeration: Cert, SerializedCert, and Pkcs12. Se si passa un altro valore, viene generata un'CryptographicException.Passing any other value causes a CryptographicException to be thrown.

Importante

Mai codificare una password all'interno del codice sorgente.Never hard code a password within your source code. È possibile recuperare le password hardcoded da un assembly utilizzando Ildasm. exe (DISASSEMBLER il), un editor esadecimale o semplicemente aprendo l'assembly in un editor di testo, ad esempio 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.

Sicurezza

KeyContainerPermission
per l'autorizzazione ad aprire un contenitore di chiavi ed esportare un certificato quando si passa il valore SerializedCert al parametro contentType.for permission to open a key container and export a certificate when you pass the SerializedCert value to the contentType parameter. Azione di sicurezza: Demand.Security action: Demand. Enumerazioni associate: Open, ExportAssociated enumerations: Open, Export

Si applica a