X509Certificate.Export Metodo

Definizione

Esporta l'oggetto X509Certificate corrente in una matrice di byte.

Overload

Export(X509ContentType)

Esporta l'oggetto X509Certificate corrente in una matrice di byte in un formato descritto da uno dei valori di X509ContentType.

Export(X509ContentType, SecureString)

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

Export(X509ContentType)

Esporta l'oggetto X509Certificate corrente in una matrice di byte in un formato descritto da uno dei valori di X509ContentType.

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

Parametri

contentType
X509ContentType

Uno dei valori di X509ContentType che indica come formattare i dati di output.

Restituisce

Byte[]

Matrice di byte che rappresenta l'oggetto X509Certificate corrente.

Attributi

Eccezioni

Un valore diverso da Cert, SerializedCert o Pkcs12 è stato passato al parametro contentType.

-oppure- Non è possibile esportare il certificato.

Esempio

Nell'esempio seguente viene caricato un file di certificato X.509 in un X509Certificate oggetto, esporta il certificato come matrice di byte e quindi importa la matrice di byte in un altro X509Certificate oggetto.

C#
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);
    }
}

Commenti

Il contentType parametro accetta solo i valori seguenti dell'enumerazione X509ContentType : Cert, SerializedCerte Pkcs12. Il passaggio di qualsiasi altro valore causa la creazione di un CryptographicException oggetto.

Si applica a

.NET 7 e altre versioni
Prodotto Versioni
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

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.

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

Parametri

contentType
X509ContentType

Uno dei valori di X509ContentType che indica come formattare i dati di output.

password
SecureString

Password necessaria per accedere ai dati del certificato X.509.

Restituisce

Byte[]

Matrice di byte che rappresenta l'oggetto X509Certificate corrente.

Attributi

Eccezioni

Un valore diverso da Cert, SerializedCert o Pkcs12 è stato passato al parametro contentType.

-oppure- Non è possibile esportare il certificato.

Commenti

Il contentType parametro accetta solo i valori seguenti dell'enumerazione X509ContentType : Cert, SerializedCerte Pkcs12. Il passaggio di qualsiasi altro valore causa la creazione di un CryptographicException oggetto.

Importante

Codice non rigido mai una password all'interno del codice sorgente. Le password hardcoded possono essere recuperate da un assembly usando il Ildasm.exe (IL Disassembler) , un editor esadecimale o semplicemente aprendo l'assembly in un editor di testo, ad esempio Notepad.exe.

Si applica a

.NET 7 e altre versioni
Prodotto Versioni
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 2.0, 2.1

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.

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

Parametri

contentType
X509ContentType

Uno dei valori di X509ContentType che indica come formattare i dati di output.

password
String

Password necessaria per accedere ai dati del certificato X.509.

Restituisce

Byte[]

Matrice di byte che rappresenta l'oggetto X509Certificate corrente.

Attributi

Eccezioni

Un valore diverso da Cert, SerializedCert o Pkcs12 è stato passato al parametro contentType.

-oppure- Non è possibile esportare il certificato.

Commenti

Il contentType parametro accetta solo i valori seguenti dell'enumerazione X509ContentType : Cert, SerializedCerte Pkcs12. Il passaggio di qualsiasi altro valore causa la creazione di un CryptographicException oggetto.

Importante

Codice non rigido mai una password all'interno del codice sorgente. Le password hardcoded possono essere recuperate da un assembly usando il Ildasm.exe (IL Disassembler) , un editor esadecimale o semplicemente aprendo l'assembly in un editor di testo, ad esempio Notepad.exe.

Si applica a

.NET 7 e altre versioni
Prodotto Versioni
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1