X509Certificate Constructeurs

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.

Initialise une nouvelle instance de la classe X509Certificate.

Surcharges

X509Certificate()	Obsolète. Initialise une nouvelle instance de la classe X509Certificate.
X509Certificate(String, SecureString, X509KeyStorageFlags)	Initialise une nouvelle instance de la classe X509Certificate à l'aide d'un nom de fichier de certificat, d'un mot de passe et d'un indicateur de stockage de clé.
X509Certificate(Byte[], String, X509KeyStorageFlags)	Initialise une nouvelle instance de la classe X509Certificate à l'aide d'un tableau d'octets, d'un mot de passe et d'un indicateur de stockage de clé.
X509Certificate(Byte[], SecureString, X509KeyStorageFlags)	Initialise une nouvelle instance de la classe X509Certificate à l'aide d'un tableau d'octets, d'un mot de passe et d'un indicateur de stockage de clé.
X509Certificate(String, String)	Initialise une nouvelle instance de la classe X509Certificate en utilisant le nom d'un fichier PKCS7 signé et un mot de passe d'accès au certificat.
X509Certificate(String, SecureString)	Initialise une nouvelle instance de la classe X509Certificate à l'aide d'un nom de fichier de certificat et d'un mot de passe.
X509Certificate(SerializationInfo, StreamingContext)	Initialise une nouvelle instance de la classe X509Certificate à l'aide d'un objet SerializationInfo et d'une structure StreamingContext.
X509Certificate(String, String, X509KeyStorageFlags)	Initialise une nouvelle instance de la classe X509Certificate en utilisant le nom d'un fichier PKCS7 signé, un mot de passe d'accès au certificat et un indicateur de stockage de clé.
X509Certificate(Byte[], SecureString)	Initialise une nouvelle instance de la classe X509Certificate à l'aide d'un tableau d'octets et d'un mot de passe.
X509Certificate(String)	Initialise une nouvelle instance de la classe X509Certificate en utilisant le nom d'un fichier PKCS7 signé.
X509Certificate(X509Certificate)	Initialise une nouvelle instance de la classe X509Certificate avec une autre classe X509Certificate.
X509Certificate(IntPtr)	Initialise une nouvelle instance de la classe X509Certificate à l'aide d'un handle vers une structure `PCCERT_CONTEXT` non managée.
X509Certificate(Byte[])	Initialise une nouvelle instance de la classe X509Certificate définie à partir d'une séquence d'octets représentant un certificat X.509v3.
X509Certificate(Byte[], String)	Initialise une nouvelle instance de la classe X509Certificate à l'aide d'un tableau d'octets et d'un mot de passe.

X509Certificate()

Attention

X509Certificate and X509Certificate2 are immutable. Use the appropriate constructor to create a new certificate.

Initialise une nouvelle instance de la classe X509Certificate.

public:
 X509Certificate();

public X509Certificate ();

[System.Obsolete("X509Certificate and X509Certificate2 are immutable. Use the appropriate constructor to create a new certificate.", DiagnosticId="SYSLIB0026", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public X509Certificate ();

[System.Obsolete("X509Certificate and X509Certificate2 are immutable. Use the appropriate constructor to create a new certificate.", DiagnosticId="SYSLIB0026", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate ();

Public Sub New ()

Attributs: ObsoleteAttribute UnsupportedOSPlatformAttribute

Remarques

ASN.1 DER est le seul format de certificat pris en charge par cette classe.

S’applique à

X509Certificate(String, SecureString, X509KeyStorageFlags)

Important

Cette API n’est pas conforme CLS.

Initialise une nouvelle instance de la classe X509Certificate à l'aide d'un nom de fichier de certificat, d'un mot de passe et d'un indicateur de stockage de clé.

public:
 X509Certificate(System::String ^ fileName, System::Security::SecureString ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);

[System.CLSCompliant(false)]
public X509Certificate (string fileName, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[System.CLSCompliant(false)]
public X509Certificate (string fileName, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

public X509Certificate (string fileName, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate

[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate

new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate

Public Sub New (fileName As String, password As SecureString, keyStorageFlags As X509KeyStorageFlags)

Paramètres

fileName: String

Nom d'un fichier de certificat.

password: SecureString

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

keyStorageFlags: X509KeyStorageFlags

Combinaison d'opérations de bits des valeurs d'énumération qui contrôlent le mode et le lieu d'importation du certificat.

Attributs: CLSCompliantAttribute UnsupportedOSPlatformAttribute

Exceptions

CryptographicException

Une erreur se produit avec le certificat. Exemple :

Le fichier de certificat n’existe pas.
Le certificat n’est pas valide.
Le mot de passe du certificat est incorrect.

ArgumentException

Le paramètre fileName a la valeur null.

Remarques

Si vous créez un X509Certificate certificat en spécifiant un magasin de fichiers signé PKCS7 pour fileName, il X509Certificate est créé pour le certificat qui a signé le magasin plutôt que pour l’un des certificats au sein du magasin.

S’applique à

X509Certificate(Byte[], String, X509KeyStorageFlags)

Initialise une nouvelle instance de la classe X509Certificate à l'aide d'un tableau d'octets, d'un mot de passe et d'un indicateur de stockage de clé.

public:
 X509Certificate(cli::array <System::Byte> ^ rawData, System::String ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);

public X509Certificate (byte[] rawData, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] rawData, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

public X509Certificate (byte[] rawData, string password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate

Public Sub New (rawData As Byte(), password As String, keyStorageFlags As X509KeyStorageFlags)

Paramètres

rawData: Byte[]

Tableau d'octets contenant les données d'un certificat X.509.

password: String

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

keyStorageFlags: X509KeyStorageFlags

Combinaison d'opérations de bits des valeurs d'énumération qui contrôlent le mode et le lieu d'importation du certificat.

Attributs: UnsupportedOSPlatformAttribute

Exceptions

CryptographicException

Une erreur se produit avec le certificat. Exemple :

Le fichier de certificat n’existe pas.
Le certificat n’est pas valide.
Le mot de passe du certificat est incorrect.

ArgumentException

Le paramètre rawData a la valeur null.

ou - La longueur du paramètre rawData est égale à 0.

Remarques

Ce constructeur crée un X509Certificate objet à l’aide d’un tableau d’octets, d’un mot de passe nécessaire pour accéder aux données de certificat et d’un indicateur de stockage de clé. L’appel de ce constructeur avec le mot de passe correct déchiffre la clé privée et l’enregistre dans un fournisseur de services de chiffrement d’API de chiffrement (CSP) Microsoft.

La X509KeyStorageFlags valeur peut être utilisée pour contrôler où et comment la clé privée est importée.

ASN.1 DER est le seul format de certificat pris en charge par cette classe.

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.

Si vous créez un X509Certificate certificat en spécifiant un magasin de fichiers signé PKCS7 pour rawData, il X509Certificate est créé pour le certificat qui a signé le magasin plutôt que pour l’un des certificats au sein du magasin.

S’applique à

X509Certificate(Byte[], SecureString, X509KeyStorageFlags)

Important

Cette API n’est pas conforme CLS.

Initialise une nouvelle instance de la classe X509Certificate à l'aide d'un tableau d'octets, d'un mot de passe et d'un indicateur de stockage de clé.

public:
 X509Certificate(cli::array <System::Byte> ^ rawData, System::Security::SecureString ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);

[System.CLSCompliant(false)]
public X509Certificate (byte[] rawData, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] rawData, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[System.CLSCompliant(false)]
public X509Certificate (byte[] rawData, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

public X509Certificate (byte[] rawData, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate

[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate

new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate

Public Sub New (rawData As Byte(), password As SecureString, keyStorageFlags As X509KeyStorageFlags)

Paramètres

rawData: Byte[]

Tableau d'octets qui contient les données d'un certificat X.509.

password: SecureString

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

keyStorageFlags: X509KeyStorageFlags

Combinaison d'opérations de bits des valeurs d'énumération qui contrôlent le mode et le lieu d'importation du certificat.

Attributs: CLSCompliantAttribute UnsupportedOSPlatformAttribute

Exceptions

CryptographicException

Une erreur se produit avec le certificat. Exemple :

Le fichier de certificat n’existe pas.
Le certificat n’est pas valide.
Le mot de passe du certificat est incorrect.

ArgumentException

Le paramètre rawData a la valeur null.

ou - La longueur du paramètre rawData est égale à 0.

Remarques

L’appel de ce constructeur avec le mot de passe correct déchiffre la clé privée et l’enregistre dans un fournisseur de services de chiffrement d’API de chiffrement (CSP) Microsoft.

ASN.1 DER est le seul format de certificat pris en charge par cette classe.

Important

S’applique à

X509Certificate(String, String)

Initialise une nouvelle instance de la classe X509Certificate en utilisant le nom d'un fichier PKCS7 signé et un mot de passe d'accès au certificat.

public:
 X509Certificate(System::String ^ fileName, System::String ^ password);

public X509Certificate (string fileName, string? password);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName, string? password);

public X509Certificate (string fileName, string password);

new System.Security.Cryptography.X509Certificates.X509Certificate : string * string -> System.Security.Cryptography.X509Certificates.X509Certificate

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * string -> System.Security.Cryptography.X509Certificates.X509Certificate

Public Sub New (fileName As String, password As String)

Paramètres

fileName: String

Nom d'un fichier PKCS7 signé.

password: String

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

Attributs: UnsupportedOSPlatformAttribute

Exceptions

CryptographicException

Une erreur se produit avec le certificat. Exemple :

Le fichier de certificat n’existe pas.
Le certificat n’est pas valide.
Le mot de passe du certificat est incorrect.

ArgumentException

Le paramètre fileName a la valeur null.

Remarques

ASN.1 DER est le seul format de certificat pris en charge par cette classe. L’appel de ce constructeur avec le mot de passe correct déchiffre la clé privée et l’enregistre dans un conteneur de clés.

S’applique à

X509Certificate(String, SecureString)

Important

Cette API n’est pas conforme CLS.

Initialise une nouvelle instance de la classe X509Certificate à l'aide d'un nom de fichier de certificat et d'un mot de passe.

public:
 X509Certificate(System::String ^ fileName, System::Security::SecureString ^ password);

[System.CLSCompliant(false)]
public X509Certificate (string fileName, System.Security.SecureString? password);

[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName, System.Security.SecureString? password);

[System.CLSCompliant(false)]
public X509Certificate (string fileName, System.Security.SecureString password);

public X509Certificate (string fileName, System.Security.SecureString password);

[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate

[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate

new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate

Public Sub New (fileName As String, password As SecureString)

Paramètres

fileName: String

Nom d'un fichier de certificat.

password: SecureString

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

Attributs: CLSCompliantAttribute UnsupportedOSPlatformAttribute

Exceptions

CryptographicException

Une erreur se produit avec le certificat. Exemple :

Le fichier de certificat n’existe pas.
Le certificat n’est pas valide.
Le mot de passe du certificat est incorrect.

ArgumentException

Le paramètre fileName a la valeur null.

Remarques

Important

S’applique à

X509Certificate(SerializationInfo, StreamingContext)

Initialise une nouvelle instance de la classe X509Certificate à l'aide d'un objet SerializationInfo et d'une structure StreamingContext.

public:
 X509Certificate(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);

public X509Certificate (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

new System.Security.Cryptography.X509Certificates.X509Certificate : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Security.Cryptography.X509Certificates.X509Certificate

Public Sub New (info As SerializationInfo, context As StreamingContext)

Paramètres

info: SerializationInfo

Objet SerializationInfo qui décrit les informations de sérialisation.

context: StreamingContext

Structure StreamingContext qui décrit la façon dont la sérialisation doit être exécutée.

Exceptions

CryptographicException

Une erreur se produit avec le certificat. Exemple :

Le fichier de certificat n’existe pas.
Le certificat n’est pas valide.
Le mot de passe du certificat est incorrect.

S’applique à

X509Certificate(String, String, X509KeyStorageFlags)

Initialise une nouvelle instance de la classe X509Certificate en utilisant le nom d'un fichier PKCS7 signé, un mot de passe d'accès au certificat et un indicateur de stockage de clé.

public:
 X509Certificate(System::String ^ fileName, System::String ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);

public X509Certificate (string fileName, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

public X509Certificate (string fileName, string password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

new System.Security.Cryptography.X509Certificates.X509Certificate : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate

Public Sub New (fileName As String, password As String, keyStorageFlags As X509KeyStorageFlags)

Paramètres

fileName: String

Nom d'un fichier PKCS7 signé.

password: String

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

keyStorageFlags: X509KeyStorageFlags

Combinaison d'opérations de bits des valeurs d'énumération qui contrôlent le mode et le lieu d'importation du certificat.

Attributs: UnsupportedOSPlatformAttribute

Exceptions

CryptographicException

Une erreur se produit avec le certificat. Exemple :

Le fichier de certificat n’existe pas.
Le certificat n’est pas valide.
Le mot de passe du certificat est incorrect.

ArgumentException

Le paramètre fileName a la valeur null.

Remarques

S’applique à

X509Certificate(Byte[], SecureString)

Important

Cette API n’est pas conforme CLS.

Initialise une nouvelle instance de la classe X509Certificate à l'aide d'un tableau d'octets et d'un mot de passe.

public:
 X509Certificate(cli::array <System::Byte> ^ rawData, System::Security::SecureString ^ password);

[System.CLSCompliant(false)]
public X509Certificate (byte[] rawData, System.Security.SecureString? password);

[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] rawData, System.Security.SecureString? password);

[System.CLSCompliant(false)]
public X509Certificate (byte[] rawData, System.Security.SecureString password);

public X509Certificate (byte[] rawData, System.Security.SecureString password);

[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate

[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate

new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate

Public Sub New (rawData As Byte(), password As SecureString)

Paramètres

rawData: Byte[]

Tableau d'octets qui contient les données d'un certificat X.509.

password: SecureString

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

Attributs: CLSCompliantAttribute UnsupportedOSPlatformAttribute

Exceptions

CryptographicException

Une erreur se produit avec le certificat. Exemple :

Le fichier de certificat n’existe pas.
Le certificat n’est pas valide.
Le mot de passe du certificat est incorrect.

ArgumentException

Le paramètre rawData a la valeur null.

ou - La longueur du paramètre rawData est égale à 0.

Remarques

ASN.1 DER est le seul format de certificat pris en charge par cette classe.

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 de l' Ildasm.exe (désassembleur IL), d’un éditeur hex ou simplement d’ouvrir l’assembly dans un éditeur de texte tel que Notepad.exe.

S’applique à

X509Certificate(String)

Initialise une nouvelle instance de la classe X509Certificate en utilisant le nom d'un fichier PKCS7 signé.

public:
 X509Certificate(System::String ^ fileName);

public X509Certificate (string fileName);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName);

new System.Security.Cryptography.X509Certificates.X509Certificate : string -> System.Security.Cryptography.X509Certificates.X509Certificate

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string -> System.Security.Cryptography.X509Certificates.X509Certificate

Public Sub New (fileName As String)

Paramètres

fileName: String

Nom d'un fichier PKCS7 signé.

Attributs: UnsupportedOSPlatformAttribute

Exceptions

CryptographicException

Une erreur se produit avec le certificat. Exemple :

Le fichier de certificat n’existe pas.
Le certificat n’est pas valide.
Le mot de passe du certificat est incorrect.

ArgumentException

Le paramètre fileName a la valeur null.

Exemples

L’exemple suivant charge un certificat X.509 à partir d’un fichier, appelle la ToString méthode et affiche les résultats dans la console.

using namespace System;
using namespace System::Security::Cryptography::X509Certificates;
int main()
{
   
   // The path to the certificate.
   String^ Certificate = L"Certificate.cer";
   
   // Load the certificate into an X509Certificate object.
   X509Certificate^ cert = gcnew X509Certificate( Certificate );
   
   // Get the value.
   String^ resultsTrue = cert->ToString( true );
   
   // Display the value to the console.
   Console::WriteLine( resultsTrue );
   
   // Get the value.
   String^ resultsFalse = cert->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 = "Certificate.cer";

        // Load the certificate into an X509Certificate object.
        X509Certificate cert = new X509Certificate(Certificate);

        // Get the value.
        string resultsTrue = cert.ToString(true);

        // Display the value to the console.
        Console.WriteLine(resultsTrue);

        // Get the value.
        string resultsFalse = cert.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 = "Certificate.cer"

        ' Load the certificate into an X509Certificate object.
        Dim cert As New X509Certificate(Certificate)

        ' Get the value.
        Dim resultsTrue As String = cert.ToString(True)

        ' Display the value to the console.
        Console.WriteLine(resultsTrue)

        ' Get the value.
        Dim resultsFalse As String = cert.ToString(False)

        ' Display the value to the console.
        Console.WriteLine(resultsFalse)

    End Sub
End Module

Remarques

ASN.1 DER est le seul format de certificat pris en charge par cette classe.

S’applique à

X509Certificate(X509Certificate)

Initialise une nouvelle instance de la classe X509Certificate avec une autre classe X509Certificate.

public:
 X509Certificate(System::Security::Cryptography::X509Certificates::X509Certificate ^ cert);

public X509Certificate (System.Security.Cryptography.X509Certificates.X509Certificate cert);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (System.Security.Cryptography.X509Certificates.X509Certificate cert);

new System.Security.Cryptography.X509Certificates.X509Certificate : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Security.Cryptography.X509Certificates.X509Certificate

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Security.Cryptography.X509Certificates.X509Certificate

Public Sub New (cert As X509Certificate)

Paramètres

cert: X509Certificate

Classe X509Certificate à partir de laquelle initialiser cette classe.

Attributs: UnsupportedOSPlatformAttribute

Exceptions

CryptographicException

Une erreur se produit avec le certificat. Exemple :

Le fichier de certificat n’existe pas.
Le certificat n’est pas valide.
Le mot de passe du certificat est incorrect.

ArgumentNullException

La valeur du paramètre cert est null.

Remarques

ASN.1 DER est le seul format de certificat pris en charge par cette classe.

S’applique à

X509Certificate(IntPtr)

Initialise une nouvelle instance de la classe X509Certificate à l'aide d'un handle vers une structure PCCERT_CONTEXT non managée.

public:
 X509Certificate(IntPtr handle);

public X509Certificate (IntPtr handle);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (IntPtr handle);

[System.Security.SecurityCritical]
public X509Certificate (IntPtr handle);

new System.Security.Cryptography.X509Certificates.X509Certificate : nativeint -> System.Security.Cryptography.X509Certificates.X509Certificate

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : nativeint -> System.Security.Cryptography.X509Certificates.X509Certificate

[<System.Security.SecurityCritical>]
new System.Security.Cryptography.X509Certificates.X509Certificate : nativeint -> System.Security.Cryptography.X509Certificates.X509Certificate

Public Sub New (handle As IntPtr)

Paramètres

handle: IntPtr
nativeint

Handle vers une structure PCCERT_CONTEXT non managée.

Attributs: UnsupportedOSPlatformAttribute SecurityCriticalAttribute

Exceptions

CryptographicException

Une erreur se produit avec le certificat. Exemple :

Le fichier de certificat n’existe pas.
Le certificat n’est pas valide.
Le mot de passe du certificat est incorrect.

ArgumentException

Le paramètre Handle ne représente pas une structure PCCERT_CONTEXT valide.

Remarques

Ce constructeur crée un objet X509Certificate à l’aide d’un handle pour le contexte de certificat d’API de chiffrement Microsoft, PCCERT_CONTEXT.

Important

Ce constructeur crée une copie du contexte de certificat. Ne supposez pas que la structure de contexte que vous avez passée au constructeur est valide ; il a peut-être été libéré. Vous pouvez obtenir une copie de la structure actuelle PCCERT_CONTEXT à partir de la Handle propriété, mais elle est valide uniquement pendant la durée de vie de l’objet X509Certificate .

S’applique à

X509Certificate(Byte[])

Initialise une nouvelle instance de la classe X509Certificate définie à partir d'une séquence d'octets représentant un certificat X.509v3.

public:
 X509Certificate(cli::array <System::Byte> ^ data);

public X509Certificate (byte[] data);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] data);

new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] -> System.Security.Cryptography.X509Certificates.X509Certificate

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] -> System.Security.Cryptography.X509Certificates.X509Certificate

Public Sub New (data As Byte())

Paramètres

data: Byte[]

Tableau d'octets contenant les données d'un certificat X.509.

Attributs: UnsupportedOSPlatformAttribute

Exceptions

CryptographicException

Une erreur se produit avec le certificat. Exemple :

Le fichier de certificat n’existe pas.
Le certificat n’est pas valide.
Le mot de passe du certificat est incorrect.

ArgumentException

Le paramètre rawData a la valeur null.

ou - La longueur du paramètre rawData est égale à 0.

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

ASN.1 DER est le seul format de certificat pris en charge par cette classe.

Si vous créez un X509Certificate certificat en spécifiant un magasin de fichiers signé PKCS7 pour data, il X509Certificate est créé pour le certificat qui a signé le magasin plutôt que pour l’un des certificats au sein du magasin.

S’applique à

X509Certificate(Byte[], String)

Initialise une nouvelle instance de la classe X509Certificate à l'aide d'un tableau d'octets et d'un mot de passe.

public:
 X509Certificate(cli::array <System::Byte> ^ rawData, System::String ^ password);

public X509Certificate (byte[] rawData, string? password);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] rawData, string? password);

public X509Certificate (byte[] rawData, string password);

new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * string -> System.Security.Cryptography.X509Certificates.X509Certificate

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * string -> System.Security.Cryptography.X509Certificates.X509Certificate

Public Sub New (rawData As Byte(), password As String)

Paramètres

rawData: Byte[]

Tableau d'octets contenant les données d'un certificat X.509.

password: String

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

Attributs: UnsupportedOSPlatformAttribute

Exceptions

CryptographicException

Une erreur se produit avec le certificat. Exemple :

Le fichier de certificat n’existe pas.
Le certificat n’est pas valide.
Le mot de passe du certificat est incorrect.

ArgumentException

Le paramètre rawData a la valeur null.

ou - La longueur du paramètre rawData est égale à 0.

Remarques

ASN.1 DER est le seul format de certificat pris en charge par cette classe.

Important

S’applique à

X509Certificate Constructeurs

Définition

Surcharges

X509Certificate()

Remarques

S’applique à

X509Certificate(String, SecureString, X509KeyStorageFlags)

Paramètres

Exceptions

Remarques

S’applique à

X509Certificate(Byte[], String, X509KeyStorageFlags)

Paramètres

Exceptions

Remarques

S’applique à

X509Certificate(Byte[], SecureString, X509KeyStorageFlags)

Paramètres

Exceptions

Remarques

S’applique à

X509Certificate(String, String)

Paramètres

Exceptions

Remarques

S’applique à

X509Certificate(String, SecureString)

Paramètres

Exceptions

Remarques

S’applique à

X509Certificate(SerializationInfo, StreamingContext)

Paramètres

Exceptions

S’applique à

X509Certificate(String, String, X509KeyStorageFlags)

Paramètres

Exceptions

Remarques

S’applique à

X509Certificate(Byte[], SecureString)

Paramètres

Exceptions

Remarques

S’applique à

X509Certificate(String)

Paramètres

Exceptions

Exemples

Remarques

S’applique à

X509Certificate(X509Certificate)

Paramètres

Exceptions

Remarques

S’applique à

X509Certificate(IntPtr)

Paramètres

Exceptions

Remarques

S’applique à

X509Certificate(Byte[])

Paramètres

Exceptions

Exemples

Remarques

S’applique à

X509Certificate(Byte[], String)

Paramètres

Exceptions

Remarques

S’applique à

Ressources supplémentaires