X509Certificate2 Constructeurs

Définition

Espace de noms:

System.Security.Cryptography.X509Certificates

Assembly:

System.Security.Cryptography.dll

Initialise une nouvelle instance de la classe X509Certificate2.

Surcharges

X509Certificate2()	Obsolète. Initialise une nouvelle instance de la classe X509Certificate2.
X509Certificate2(String, String, X509KeyStorageFlags)	Initialise une nouvelle instance de la classe X509Certificate2 à l'aide d'un nom de fichier de certificat, d'un mot de passe d'accès au certificat et d'un indicateur de stockage de clé.
X509Certificate2(String, SecureString, X509KeyStorageFlags)	Initialise une nouvelle instance de la classe X509Certificate2 à l'aide d'un nom de fichier de certificat, d'un mot de passe et d'un indicateur de stockage de clé.
X509Certificate2(String, ReadOnlySpan<Char>, X509KeyStorageFlags)	Initialise une nouvelle instance de la classe X509Certificate2 à l'aide d'un nom de fichier de certificat, d'un mot de passe et d'un indicateur de stockage de clé.
X509Certificate2(Byte[], String, X509KeyStorageFlags)	Initialise une nouvelle instance de la classe X509Certificate2 à l'aide d'un tableau d'octets, d'un mot de passe et d'un indicateur de stockage de clé.
X509Certificate2(Byte[], SecureString, X509KeyStorageFlags)	Initialise une nouvelle instance de la classe X509Certificate2 à l'aide d'un tableau d'octets, d'un mot de passe et d'un indicateur de stockage de clé.
X509Certificate2(String, String)	Initialise une nouvelle instance de la classe X509Certificate2 à l'aide d'un nom de fichier de certificat et d'un mot de passe d'accès au certificat.
X509Certificate2(String, SecureString)	Initialise une nouvelle instance de la classe X509Certificate2 à l'aide d'un nom de fichier de certificat et d'un mot de passe.
X509Certificate2(ReadOnlySpan<Byte>, ReadOnlySpan<Char>, X509KeyStorageFlags)	Initialise une nouvelle instance de la classe X509Certificate2 à partir des données de certificat, d’un mot de passe et d’indicateurs de stockage de clé.
X509Certificate2(Byte[], String)	Initialise une nouvelle instance de la classe X509Certificate2 à l'aide d'un tableau d'octets et d'un mot de passe.
X509Certificate2(Byte[], SecureString)	Initialise une nouvelle instance de la classe X509Certificate2 à l'aide d'un tableau d'octets et d'un mot de passe.
X509Certificate2(String)	Initialise une nouvelle instance de la classe X509Certificate2 à l'aide d'un nom de fichier de certificat.
X509Certificate2(X509Certificate)	Initialise une nouvelle instance de la classe X509Certificate2 avec un objet X509Certificate.
X509Certificate2(SerializationInfo, StreamingContext)	Obsolète. Initialise une nouvelle instance de la classe X509Certificate2 en utilisant les informations de contexte de sérialisation et de flux spécifiées.
X509Certificate2(ReadOnlySpan<Byte>)	Initialise une nouvelle instance de la classe X509Certificate2 à partir des données de certificat.
X509Certificate2(IntPtr)	Initialise une nouvelle instance de la classe X509Certificate2 à l'aide d'un handle non managé.
X509Certificate2(Byte[])	Initialise une nouvelle instance de la classe X509Certificate2 à l'aide des informations d'un tableau d'octets.

X509Certificate2()

Source:

X509Certificate2.cs

Attention

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

Initialise une nouvelle instance de la classe X509Certificate2.

public:
 X509Certificate2();

[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 X509Certificate2 ();

Public Sub New ()

Attributs

ObsoleteAttribute UnsupportedOSPlatformAttribute

Exemples

L’exemple de code suivant ouvre le magasin de certificats utilisateur actuel, sélectionne uniquement les certificats actifs, puis permet à l’utilisateur de sélectionner un ou plusieurs certificats. L’exemple écrit ensuite les informations de certificat dans la console.

#using <System.dll>
#using <System.Security.dll>

using namespace System;
using namespace System::Security::Cryptography;
using namespace System::Security::Permissions;
using namespace System::IO;
using namespace System::Security::Cryptography::X509Certificates;
int main()
{
   try
   {
      X509Store ^ store = gcnew X509Store( "MY",StoreLocation::CurrentUser );
      store->Open( static_cast<OpenFlags>(OpenFlags::ReadOnly | OpenFlags::OpenExistingOnly) );
      X509Certificate2Collection ^ collection = dynamic_cast<X509Certificate2Collection^>(store->Certificates);
      X509Certificate2Collection ^ fcollection = dynamic_cast<X509Certificate2Collection^>(collection->Find( X509FindType::FindByTimeValid, DateTime::Now, false ));
      X509Certificate2Collection ^ scollection = X509Certificate2UI::SelectFromCollection(fcollection, "Test Certificate Select","Select a certificate from the following list to get information on that certificate",X509SelectionFlag::MultiSelection);
      Console::WriteLine( "Number of certificates: {0}{1}", scollection->Count, Environment::NewLine );
      System::Collections::IEnumerator^ myEnum = scollection->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         X509Certificate2 ^ x509 = safe_cast<X509Certificate2 ^>(myEnum->Current);
         array<Byte>^rawdata = x509->RawData;
         Console::WriteLine( "Content Type: {0}{1}", X509Certificate2::GetCertContentType( rawdata ), Environment::NewLine );
         Console::WriteLine( "Friendly Name: {0}{1}", x509->FriendlyName, Environment::NewLine );
         Console::WriteLine( "Certificate Verified?: {0}{1}", x509->Verify(), Environment::NewLine );
         Console::WriteLine( "Simple Name: {0}{1}", x509->GetNameInfo( X509NameType::SimpleName, true ), Environment::NewLine );
         Console::WriteLine( "Signature Algorithm: {0}{1}", x509->SignatureAlgorithm->FriendlyName, Environment::NewLine );
         Console::WriteLine( "Private Key: {0}{1}", x509->PrivateKey->ToXmlString( false ), Environment::NewLine );
         Console::WriteLine( "Public Key: {0}{1}", x509->PublicKey->Key->ToXmlString( false ), Environment::NewLine );
         Console::WriteLine( "Certificate Archived?: {0}{1}", x509->Archived, Environment::NewLine );
         Console::WriteLine( "Length of Raw Data: {0}{1}", x509->RawData->Length, Environment::NewLine );
         x509->Reset();
      }
      store->Close();
   }
   catch ( CryptographicException^ ) 
   {
      Console::WriteLine( "Information could not be written out for this certificate." );
   }

}

using System;
using System.Security.Cryptography;
using System.Security.Permissions;
using System.IO;
using System.Security.Cryptography.X509Certificates;

class CertSelect
{
    static void Main()
    {
        X509Store store = new X509Store("MY",StoreLocation.CurrentUser);
        store.Open(OpenFlags.ReadOnly | OpenFlags.OpenExistingOnly);

        X509Certificate2Collection collection = (X509Certificate2Collection)store.Certificates;
        X509Certificate2Collection fcollection = (X509Certificate2Collection)collection.Find(X509FindType.FindByTimeValid,DateTime.Now,false);
        X509Certificate2Collection scollection = X509Certificate2UI.SelectFromCollection(fcollection, "Test Certificate Select","Select a certificate from the following list to get information on that certificate",X509SelectionFlag.MultiSelection);
        Console.WriteLine("Number of certificates: {0}{1}",scollection.Count,Environment.NewLine);

        foreach (X509Certificate2 x509 in scollection)
        {
            try
            {
                byte[] rawdata = x509.RawData;
                Console.WriteLine("Content Type: {0}{1}",X509Certificate2.GetCertContentType(rawdata),Environment.NewLine);
                Console.WriteLine("Friendly Name: {0}{1}",x509.FriendlyName,Environment.NewLine);
                Console.WriteLine("Certificate Verified?: {0}{1}",x509.Verify(),Environment.NewLine);
                Console.WriteLine("Simple Name: {0}{1}",x509.GetNameInfo(X509NameType.SimpleName,true),Environment.NewLine);
                Console.WriteLine("Signature Algorithm: {0}{1}",x509.SignatureAlgorithm.FriendlyName,Environment.NewLine);
                Console.WriteLine("Public Key: {0}{1}",x509.PublicKey.Key.ToXmlString(false),Environment.NewLine);
                Console.WriteLine("Certificate Archived?: {0}{1}",x509.Archived,Environment.NewLine);
                Console.WriteLine("Length of Raw Data: {0}{1}",x509.RawData.Length,Environment.NewLine);
                X509Certificate2UI.DisplayCertificate(x509);
                x509.Reset();
            }
            catch (CryptographicException)
            {
                Console.WriteLine("Information could not be written out for this certificate.");
            }
        }
        store.Close();
    }
}

Imports System.Security.Cryptography
Imports System.Security.Permissions
Imports System.IO
Imports System.Security.Cryptography.X509Certificates

Class CertSelect

    Shared Sub Main()

        Dim store As New X509Store("MY", StoreLocation.CurrentUser)
        store.Open(OpenFlags.ReadOnly Or OpenFlags.OpenExistingOnly)

        Dim collection As X509Certificate2Collection = CType(store.Certificates, X509Certificate2Collection)
        Dim fcollection As X509Certificate2Collection = CType(collection.Find(X509FindType.FindByTimeValid, DateTime.Now, False), X509Certificate2Collection)
        Dim scollection As X509Certificate2Collection = X509Certificate2UI.SelectFromCollection(fcollection, "Test Certificate Select", "Select a certificate from the following list to get information on that certificate", X509SelectionFlag.MultiSelection)
        Console.WriteLine("Number of certificates: {0}{1}", scollection.Count, Environment.NewLine)
         
        For Each x509 As X509Certificate2 In scollection
            Try
                Dim rawdata As Byte() = x509.RawData
                Console.WriteLine("Content Type: {0}{1}", X509Certificate2.GetCertContentType(rawdata), Environment.NewLine)
                Console.WriteLine("Friendly Name: {0}{1}", x509.FriendlyName, Environment.NewLine)
                Console.WriteLine("Certificate Verified?: {0}{1}", x509.Verify(), Environment.NewLine)
                Console.WriteLine("Simple Name: {0}{1}", x509.GetNameInfo(X509NameType.SimpleName, True), Environment.NewLine)
                Console.WriteLine("Signature Algorithm: {0}{1}", x509.SignatureAlgorithm.FriendlyName, Environment.NewLine)
                Console.WriteLine("Public Key: {0}{1}", x509.PublicKey.Key.ToXmlString(False), Environment.NewLine)
                Console.WriteLine("Certificate Archived?: {0}{1}", x509.Archived, Environment.NewLine)
                Console.WriteLine("Length of Raw Data: {0}{1}", x509.RawData.Length, Environment.NewLine)
                X509Certificate2UI.DisplayCertificate(x509)
                x509.Reset()         
             Catch cExcept As CryptographicException
                 Console.WriteLine("Information could not be written out for this certificate.")
             End Try
        Next x509

        store.Close()
    End Sub
End Class

Remarques

Ce constructeur crée un objet vide X509Certificate2 , contrairement aux autres constructeurs de cette classe qui utilisent les informations de certificat d’un tableau d’octets, d’un pointeur ou d’un fichier de certificat.

X509Certificate2(String, String, X509KeyStorageFlags)

Source:

X509Certificate2.cs

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

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

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

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

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

Paramètres

fileName

String

Nom d'un fichier de certificat.

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 est non valide.

• Le mot de passe du certificat est incorrect.

Remarques

Ce constructeur crée un X509Certificate2 objet à l’aide d’un nom de fichier de certificat, d’un mot de passe nécessaire pour accéder au certificat et d’un indicateur de stockage de clé.

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 en ouvrant l’assembly dans un éditeur de texte tel que Notepad.exe.

Si vous créez un X509Certificate2 certificat en spécifiant un magasin de fichiers signé PKCS7 pour fileName, le X509Certificate2 est créé pour le certificat qui a signé le magasin plutôt que pour tous les certificats dans le magasin.

X509Certificate2(String, SecureString, X509KeyStorageFlags)

Source:

X509Certificate2.cs

Important

Cette API n’est pas conforme CLS.

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

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

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

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

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 est non valide.

• Le mot de passe du certificat est incorrect.

Remarques

Si vous créez un X509Certificate certificat en spécifiant un magasin de fichiers signé PKCS7 pour fileName, le X509Certificate est créé pour le certificat qui a signé le magasin plutôt que pour tous les certificats dans le magasin.

X509Certificate2(String, ReadOnlySpan<Char>, X509KeyStorageFlags)

Source:

X509Certificate2.cs

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

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2 (string fileName, ReadOnlySpan<char> password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet);

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

Public Sub New (fileName As String, password As ReadOnlySpan(Of Char), Optional keyStorageFlags As X509KeyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet)

Paramètres

fileName

String

Nom d'un fichier de certificat.

password

ReadOnlySpan<Char>

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 est non valide.

• Le mot de passe du certificat est incorrect.

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 en ouvrant l’assembly dans un éditeur de texte tel que Notepad.exe.

Si vous créez un X509Certificate2 certificat en spécifiant un magasin de fichiers signé PKCS7 pour fileName, le X509Certificate2 est créé pour le certificat qui a signé le magasin plutôt que pour tous les certificats dans le magasin.

X509Certificate2(Byte[], String, X509KeyStorageFlags)

Source:

X509Certificate2.cs

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

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

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

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

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 est non valide.

• Le mot de passe du certificat est incorrect.

Remarques

Ce constructeur crée un X509Certificate2 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é. Il est utilisé avec les fichiers PKCS12 (PFX) qui contiennent la clé privée du certificat. 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.

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 en ouvrant l’assembly dans un éditeur de texte tel que Notepad.exe.

Si vous créez un X509Certificate2 certificat en spécifiant un magasin de fichiers signé PKCS7 pour rawData, le X509Certificate2 est créé pour le certificat qui a signé le magasin plutôt que pour tous les certificats dans le magasin.

X509Certificate2(Byte[], SecureString, X509KeyStorageFlags)

Source:

X509Certificate2.cs

Important

Cette API n’est pas conforme CLS.

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

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

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

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

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 est non valide.

• Le mot de passe du certificat est incorrect.

Remarques

Ce constructeur est utilisé avec les fichiers PKCS12 (PFX) qui contiennent la clé privée du certificat. 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 de l’API de chiffrement (CSP) Microsoft.

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 en ouvrant 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, le X509Certificate est créé pour le certificat qui a signé le magasin plutôt que pour l’un des certificats dans le magasin.

X509Certificate2(String, String)

Source:

X509Certificate2.cs

Initialise une nouvelle instance de la classe X509Certificate2 à l'aide d'un nom de fichier de certificat et d'un mot de passe d'accès au certificat.

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

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

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

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

Paramètres

fileName

String

Nom d'un fichier de certificat.

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 est non valide.

• Le mot de passe du certificat est incorrect.

Remarques

Ce constructeur crée un X509Certificate2 objet à l’aide d’un nom de fichier de certificat et d’un mot de passe nécessaire pour accéder au certificat. Il est utilisé avec les fichiers PKCS12 (PFX) qui contiennent la clé privée du certificat. 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.

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 en ouvrant l’assembly dans un éditeur de texte tel que Notepad.exe.

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

X509Certificate2(String, SecureString)

Source:

X509Certificate2.cs

Important

Cette API n’est pas conforme CLS.

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

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

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

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

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 est non valide.

• Le mot de passe du certificat est incorrect.

Remarques

Ce constructeur est utilisé avec les fichiers PKCS12 (PFX) qui contiennent la clé privée du certificat. 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.

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 en ouvrant 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 fileName, le X509Certificate est créé pour le certificat qui a signé le magasin plutôt que pour l’un des certificats dans le magasin.

X509Certificate2(ReadOnlySpan<Byte>, ReadOnlySpan<Char>, X509KeyStorageFlags)

Source:

X509Certificate2.cs

Initialise une nouvelle instance de la classe X509Certificate2 à partir des données de certificat, d’un mot de passe et d’indicateurs de stockage de clé.

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2 (ReadOnlySpan<byte> rawData, ReadOnlySpan<char> password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet);

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

Public Sub New (rawData As ReadOnlySpan(Of Byte), password As ReadOnlySpan(Of Char), Optional keyStorageFlags As X509KeyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet)

Paramètres

rawData

ReadOnlySpan<Byte>

Données de certificat à traiter.

password

ReadOnlySpan<Char>

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

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.

X509Certificate2(Byte[], String)

Source:

X509Certificate2.cs

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

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

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

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

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 est non valide.

• Le mot de passe du certificat est incorrect.

Remarques

Ce constructeur crée un X509Certificate2 objet à l’aide d’un tableau d’octets et d’un mot de passe nécessaire pour accéder aux données de certificat. Il est utilisé avec les fichiers PKCS12 (PFX) qui contiennent la clé privée du certificat. 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.

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 en ouvrant l’assembly dans un éditeur de texte tel que Notepad.exe.

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

X509Certificate2(Byte[], SecureString)

Source:

X509Certificate2.cs

Important

Cette API n’est pas conforme CLS.

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

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

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

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

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 est non valide.

• Le mot de passe du certificat est incorrect.

Remarques

Ce constructeur est utilisé avec les fichiers PKCS12 (PFX) qui contiennent la clé privée du certificat. 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.

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 en ouvrant 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, le X509Certificate est créé pour le certificat qui a signé le magasin plutôt que pour l’un des certificats dans le magasin.

X509Certificate2(String)

Source:

X509Certificate2.cs

Initialise une nouvelle instance de la classe X509Certificate2 à l'aide d'un nom de fichier de certificat.

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

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

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

Public Sub New (fileName As String)

Paramètres

fileName

String

Nom d'un fichier de certificat.

Attributs

UnsupportedOSPlatformAttribute

Exceptions

CryptographicException

Une erreur se produit avec le certificat. Exemple :

• Le fichier de certificat n’existe pas.

• Le certificat est non valide.

• Le mot de passe du certificat est incorrect.

Remarques

Ce constructeur crée un X509Certificate2 objet à l’aide d’un nom de fichier de certificat. Il prend en charge l’encodage binaire (DER) ou l’encodage base64.

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

X509Certificate2(X509Certificate)

Source:

X509Certificate2.cs

Initialise une nouvelle instance de la classe X509Certificate2 avec un objet X509Certificate.

public:
 X509Certificate2(System::Security::Cryptography::X509Certificates::X509Certificate ^ certificate);

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

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

Public Sub New (certificate As X509Certificate)

Paramètres

certificate

X509Certificate

Objet X509Certificate.

Attributs

UnsupportedOSPlatformAttribute

Exceptions

CryptographicException

Une erreur se produit avec le certificat. Exemple :

• Le fichier de certificat n’existe pas.

• Le certificat est non valide.

• Le mot de passe du certificat est incorrect.

Remarques

Cette méthode crée une nouvelle instance de la classe à l’aide X509Certificate2 d’un X509Certificate objet .

X509Certificate2(SerializationInfo, StreamingContext)

Source:

X509Certificate2.cs

Attention

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

Initialise une nouvelle instance de la classe X509Certificate2 en utilisant les informations de contexte de sérialisation et de flux spécifiées.

protected:
 X509Certificate2(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected X509Certificate2 (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.X509Certificates.X509Certificate2 : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Security.Cryptography.X509Certificates.X509Certificate2

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

Paramètres

info

SerializationInfo

Informations de sérialisation nécessaires pour désérialiser le nouveau X509Certificate2.

context

StreamingContext

Informations contextuelles sur la source du flux à désérialiser.

Attributs

ObsoleteAttribute

Exceptions

PlatformNotSupportedException

.NET Core et .NET 5 (et versions ultérieures) uniquement : Dans tous les cas.

X509Certificate2(ReadOnlySpan<Byte>)

Source:

X509Certificate2.cs

Initialise une nouvelle instance de la classe X509Certificate2 à partir des données de certificat.

public:
 X509Certificate2(ReadOnlySpan<System::Byte> rawData);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2 (ReadOnlySpan<byte> rawData);

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

Public Sub New (rawData As ReadOnlySpan(Of Byte))

Paramètres

rawData

ReadOnlySpan<Byte>

Données de certificat à traiter.

Attributs

UnsupportedOSPlatformAttribute

Exceptions

CryptographicException

Une erreur se produit avec le certificat.

X509Certificate2(IntPtr)

Source:

X509Certificate2.cs

Initialise une nouvelle instance de la classe X509Certificate2 à l'aide d'un handle non managé.

public:
 X509Certificate2(IntPtr handle);

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

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

Public Sub New (handle As IntPtr)

Paramètres

handle

IntPtr

nativeint

Pointeur vers un contexte de certificat dans du code non managé. La structure C est appelée PCCERT_CONTEXT.

Attributs

UnsupportedOSPlatformAttribute

Exceptions

CryptographicException

Une erreur se produit avec le certificat. Exemple :

• Le fichier de certificat n’existe pas.

• Le certificat est non valide.

• Le mot de passe du certificat est incorrect.

Remarques

Ce constructeur crée un X509Certificate2 objet à l’aide d’un handle pour le contexte de certificat de l’API de chiffrement Microsoft, PCCERT_CONTEXT. Notez que l’appelant immédiat de ce constructeur nécessite une autorisation de code non managé.

Important

Le constructeur crée une copie du contexte de certificat. Ne partez pas du principe 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 X509Certificate2 .

X509Certificate2(Byte[])

Source:

X509Certificate2.cs

Initialise une nouvelle instance de la classe X509Certificate2 à l'aide des informations d'un tableau d'octets.

public:
 X509Certificate2(cli::array <System::Byte> ^ rawData);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate2 (byte[] rawData);

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

Public Sub New (rawData As Byte())

Paramètres

rawData

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 est non valide.

• Le mot de passe du certificat est incorrect.

Remarques

Ce constructeur crée un objet à l’aide X509Certificate2 des informations de certificat d’un tableau d’octets. Le tableau d’octets peut contenir des données X.509 codées en binaire (DER) ou en Base64. Le tableau d’octets peut également être un fichier signé PKCS7 (Authenticode) ; le certificat de signataire est utilisé pour créer l’objet .

Si vous créez un X509Certificate2 certificat en spécifiant un magasin de fichiers signé PKCS7 pour rawData, le X509Certificate2 est créé pour le certificat qui a signé le magasin plutôt que pour tous les certificats dans le magasin.