X509Certificate.Export Méthode

Référence

Définition

Espace de noms:: System.Security.Cryptography.X509Certificates

Assembly:: System.Security.Cryptography.X509Certificates.dll

Assembly:: System.Security.Cryptography.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Exporte l'objet X509Certificate en cours dans un tableau d'octets.

Surcharges

Export(X509ContentType)	Exporte l'objet X509Certificate en cours dans un tableau d'octets dans un format décrit par l'une des valeurs X509ContentType.
Export(X509ContentType, SecureString)	Exporte l'objet X509Certificate en cours dans un tableau d'octets à l'aide du format spécifié et d'un mot de passe.
Export(X509ContentType, String)	Exporte l'objet X509Certificate en cours dans un tableau d'octets dans un format décrit par l'une des valeurs X509ContentType, et à l'aide du mot de passe spécifié.

Export(X509ContentType)

Exporte l'objet X509Certificate en cours dans un tableau d'octets dans un format décrit par l'une des valeurs X509ContentType.

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()

Paramètres

contentType: X509ContentType

Une des valeurs X509ContentType décrivant comment mettre en forme les données obtenues.

Retours

Byte[]

Tableau d'octets qui représente l'objet X509Certificate en cours.

Attributs: ComVisibleAttribute

Exceptions

CryptographicException

Une valeur autre que Cert, SerializedCert ou Pkcs12 a été passée au paramètre contentType.

ou - Le certificat n'a pas pu être exporté.

Exemples

L’exemple suivant charge un fichier de certificat X.509 dans un X509Certificate objet, exporte le certificat en tant que tableau d’octets, puis importe le tableau d’octets dans un autre X509Certificate objet.

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

Remarques

Le contentType paramètre accepte uniquement les valeurs suivantes de l’énumération X509ContentType : Cert, SerializedCertet Pkcs12. La transmission d’une autre valeur entraîne la levée d’une CryptographicException valeur.

S’applique à

Export(X509ContentType, SecureString)

Important

Cette API n’est pas conforme CLS.

Exporte l'objet X509Certificate en cours dans un tableau d'octets à l'aide du format spécifié et d'un mot de passe.

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()

Paramètres

contentType: X509ContentType

Une des valeurs X509ContentType décrivant comment mettre en forme les données obtenues.

password: SecureString

Mot de passe requis pour accéder aux données du certificat X.509.

Retours

Byte[]

Tableau d'octets qui représente l'objet X509Certificate en cours.

Attributs: CLSCompliantAttribute

Exceptions

CryptographicException

Une valeur autre que Cert, SerializedCert ou Pkcs12 a été passée au paramètre contentType.

ou - Le certificat n'a pas pu être exporté.

Remarques

Important

Ne codez jamais en dur un mot de passe dans votre code source. Les mots de passe codés en dur peuvent être récupérés à partir d’un assembly à l’aide du Ildasm.exe (désassembleur IL), d’un éditeur hexadécimal ou simplement d’ouvrir l’assembly dans un éditeur de texte tel que Notepad.exe.

S’applique à

Export(X509ContentType, String)

Exporte l'objet X509Certificate en cours dans un tableau d'octets dans un format décrit par l'une des valeurs X509ContentType, et à l'aide du mot de passe spécifié.

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()

Paramètres

contentType: X509ContentType

Une des valeurs X509ContentType décrivant comment mettre en forme les données obtenues.

password: String

Mot de passe requis pour accéder aux données du certificat X.509.

Retours

Byte[]

Tableau d'octets qui représente l'objet X509Certificate en cours.

Attributs: ComVisibleAttribute

Exceptions

CryptographicException

Une valeur autre que Cert, SerializedCert ou Pkcs12 a été passée au paramètre contentType.

ou - Le certificat n'a pas pu être exporté.

Remarques

Important

S’applique à

X509Certificate.Export Méthode

Définition

Surcharges

Export(X509ContentType)

Paramètres

Retours

Exceptions

Exemples

Remarques

S’applique à

Export(X509ContentType, SecureString)

Paramètres

Retours

Exceptions

Remarques

S’applique à

Export(X509ContentType, String)

Paramètres

Retours

Exceptions

Remarques

S’applique à

Ressources supplémentaires