X509Certificate2.Import Méthode

Définition

Espace de noms:

System.Security.Cryptography.X509Certificates

Assembly:

System.Security.Cryptography.dll

Remplit un objet X509Certificate2 avec les informations de certificat fournies.

Surcharges

Import(Byte[])	Obsolète. Remplit un objet X509Certificate2 avec les données d'un tableau d'octets.
Import(String)	Obsolète. Remplit un objet X509Certificate2 avec des informations d'un fichier de certificat.
Import(Byte[], SecureString, X509KeyStorageFlags)	Obsolète. Remplit un objet X509Certificate2 à l'aide de données d'un tableau d'octets, d'un mot de passe et d'un indicateur de stockage de clé.
Import(Byte[], String, X509KeyStorageFlags)	Obsolète. Remplit un objet X509Certificate2 à l'aide de données d'un tableau d'octets, d'un mot de passe et d'indicateurs qui déterminent comment importer la clé privée.
Import(String, SecureString, X509KeyStorageFlags)	Obsolète. Remplit un objet X509Certificate2 avec les informations d'un fichier de certificat, d'un mot de passe et d'un indicateur de stockage de clé.
Import(String, String, X509KeyStorageFlags)	Obsolète. Remplit l'objet X509Certificate2 avec des informations venant d'un fichier de certificat, un mot de passe et une valeur X509KeyStorageFlags.

Import(Byte[])

Source:

X509Certificate2.cs

Attention

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

Remplit un objet X509Certificate2 avec les données d'un tableau d'octets.

public:
 override void Import(cli::array <System::Byte> ^ rawData);

[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 override void Import (byte[] rawData);

[<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}")>]
override this.Import : byte[] -> unit

Public Overrides Sub Import (rawData As Byte())

Paramètres

rawData

Byte[]

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

Attributs

ObsoleteAttribute

Remarques

Cette méthode peut être utilisée pour prendre un tableau d’octets brut d’un certificat X.509 et remplir l’objet X509Certificate2 avec ses valeurs associées.

Étant donné que cette méthode accepte uniquement un tableau d’octets, elle peut être utilisée uniquement pour les types de certificats qui ne nécessitent pas de mot de passe, y compris un certificat X.509 encodé en Base64 ou ENR ou un certificat PFX/PKCS12. Notez qu’un certificat PFX/PKCS12 peut contenir plusieurs certificats. Dans ce cas, le premier certificat associé à une clé privée est utilisé ou, si aucune clé privée n’est trouvée, le premier certificat est utilisé.

Import(String)

Source:

X509Certificate2.cs

Attention

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

Remplit un objet X509Certificate2 avec des informations d'un fichier de certificat.

public:
 override void Import(System::String ^ fileName);

[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 override void Import (string fileName);

[<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}")>]
override this.Import : string -> unit

Public Overrides Sub Import (fileName As String)

Paramètres

fileName

String

Nom du certificat.

Attributs

ObsoleteAttribute

Remarques

Cette méthode utilise un fichier de certificat, tel qu’un fichier avec une extension .cer, qui représente un certificat X.509 et remplit l’objet X509Certificate2 avec le certificat que contient le fichier.

Cette méthode peut être utilisée avec plusieurs types de certificats, notamment des certificats X.509 codés en Base64 ou ENR, des certificats PFX/PKCS12 et des certificats de signataire tels qu’Authenticode. Notez qu’un certificat PFX/PKCS12 peut contenir plusieurs certificats. Dans ce cas, le premier certificat associé à une clé privée est utilisé ou, si aucune clé privée n’est trouvée, le premier certificat est utilisé.

Import(Byte[], SecureString, X509KeyStorageFlags)

Source:

X509Certificate2.cs

Attention

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

Important

Cette API n’est pas conforme CLS.

Remplit un objet X509Certificate2 à l'aide de données d'un tableau d'octets, d'un mot de passe et d'un indicateur de stockage de clé.

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

[System.CLSCompliant(false)]
[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 override void Import (byte[] rawData, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[<System.CLSCompliant(false)>]
[<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}")>]
override this.Import : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit

Public Overrides Sub Import (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 ObsoleteAttribute

Remarques

Vous pouvez utiliser cette méthode pour les types de certificats tels que les certificats X.509 encodés en Base64 ou ENR, ou les certificats PFX/PKCS12. Notez qu’un certificat PFX/PKCS12 peut contenir plusieurs certificats. Dans ce cas, le premier certificat associé à une clé privée est utilisé ou, si aucune clé privée n’est trouvée, le premier certificat est utilisé.

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.

Import(Byte[], String, X509KeyStorageFlags)

Source:

X509Certificate2.cs

Attention

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

Remplit un objet X509Certificate2 à l'aide de données d'un tableau d'octets, d'un mot de passe et d'indicateurs qui déterminent comment importer la clé privée.

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

[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 override void Import (byte[] rawData, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[<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}")>]
override this.Import : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit

Public Overrides Sub Import (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

ObsoleteAttribute

Exemples

L’exemple de code suivant crée un exécutable de ligne de commande qui prend un fichier de certificat en tant qu’argument et imprime différentes propriétés de certificat dans la console.

#using <System.dll>

using namespace System;
using namespace System::Security::Cryptography;
using namespace System::Security::Permissions;
using namespace System::IO;
using namespace System::Security::Cryptography::X509Certificates;

//Reads a file.
array<Byte>^ ReadFile( String^ fileName )
{
   FileStream^ f = gcnew FileStream( fileName,FileMode::Open,FileAccess::Read );
   int size = (int)f->Length;
   array<Byte>^data = gcnew array<Byte>(size);
   size = f->Read( data, 0, size );
   f->Close();
   return data;
}

[SecurityPermissionAttribute(SecurityAction::LinkDemand, Unrestricted = true)]
int main()
{
   array<String^>^args = Environment::GetCommandLineArgs();

   //Test for correct number of arguments.
   if ( args->Length < 2 )
   {
      Console::WriteLine( "Usage: CertInfo <filename>" );
      return  -1;
   }

   try
   {
      System::Security::Cryptography::X509Certificates::X509Certificate2 ^ x509 =
            gcnew System::Security::Cryptography::X509Certificates::X509Certificate2;

      //Create X509Certificate2 object from .cer file.
      array<Byte>^rawData = ReadFile( args[ 1 ] );

      x509->Import(rawData);

      //Print to console information contained in the certificate.
      Console::WriteLine( "{0}Subject: {1}{0}", Environment::NewLine, x509->Subject );
      Console::WriteLine( "{0}Issuer: {1}{0}", Environment::NewLine, x509->Issuer );
      Console::WriteLine( "{0}Version: {1}{0}", Environment::NewLine, x509->Version );
      Console::WriteLine( "{0}Valid Date: {1}{0}", Environment::NewLine, x509->NotBefore );
      Console::WriteLine( "{0}Expiry Date: {1}{0}", Environment::NewLine, x509->NotAfter );
      Console::WriteLine( "{0}Thumbprint: {1}{0}", Environment::NewLine, x509->Thumbprint );
      Console::WriteLine( "{0}Serial Number: {1}{0}", Environment::NewLine, x509->SerialNumber );
      Console::WriteLine( "{0}Friendly Name: {1}{0}", Environment::NewLine, x509->PublicKey->Oid->FriendlyName );
      Console::WriteLine( "{0}Public Key Format: {1}{0}", Environment::NewLine, x509->PublicKey->EncodedKeyValue->Format(true) );
      Console::WriteLine( "{0}Raw Data Length: {1}{0}", Environment::NewLine, x509->RawData->Length );
      Console::WriteLine( "{0}Certificate to string: {1}{0}", Environment::NewLine, x509->ToString( true ) );
      Console::WriteLine( "{0}Certificate to XML String: {1}{0}", Environment::NewLine, x509->PublicKey->Key->ToXmlString( false ) );

      //Add the certificate to a X509Store.
      X509Store ^ store = gcnew X509Store;
      store->Open( OpenFlags::MaxAllowed );
      store->Add( x509 );
      store->Close();
   }
   catch ( DirectoryNotFoundException^ )
   {
      Console::WriteLine( "Error: The directory specified could not be found." );
   }
   catch ( IOException^ )
   {
      Console::WriteLine( "Error: A file in the directory could not be accessed." );
   }
   catch ( NullReferenceException^ )
   {
      Console::WriteLine( "File must be a .cer file. Program does not have access to that type of file." );
   }

}

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

class CertInfo
{
    //Reads a file.
    internal static byte[] ReadFile (string fileName)
    {
        FileStream f = new FileStream(fileName, FileMode.Open, FileAccess.Read);
        int size = (int)f.Length;
        byte[] data = new byte[size];
        size = f.Read(data, 0, size);
        f.Close();
        return data;
    }
    //Main method begins here.
    static void Main(string[] args)
    {
        //Test for correct number of arguments.
        if (args.Length < 1)
        {
            Console.WriteLine("Usage: CertInfo <filename>");
            return;
        }
        try
        {
            X509Certificate2 x509 = new X509Certificate2();
            //Create X509Certificate2 object from .cer file.
            byte[] rawData = ReadFile(args[0]);
            x509.Import(rawData);

            //Print to console information contained in the certificate.
            Console.WriteLine("{0}Subject: {1}{0}", Environment.NewLine, x509.Subject);
            Console.WriteLine("{0}Issuer: {1}{0}", Environment.NewLine, x509.Issuer);
            Console.WriteLine("{0}Version: {1}{0}", Environment.NewLine, x509.Version);
            Console.WriteLine("{0}Valid Date: {1}{0}", Environment.NewLine, x509.NotBefore);
            Console.WriteLine("{0}Expiry Date: {1}{0}", Environment.NewLine, x509.NotAfter);
            Console.WriteLine("{0}Thumbprint: {1}{0}", Environment.NewLine, x509.Thumbprint);
            Console.WriteLine("{0}Serial Number: {1}{0}", Environment.NewLine, x509.SerialNumber);
            Console.WriteLine("{0}Friendly Name: {1}{0}", Environment.NewLine, x509.PublicKey.Oid.FriendlyName);
            Console.WriteLine("{0}Public Key Format: {1}{0}", Environment.NewLine, x509.PublicKey.EncodedKeyValue.Format(true));
            Console.WriteLine("{0}Raw Data Length: {1}{0}", Environment.NewLine, x509.RawData.Length);
            Console.WriteLine("{0}Certificate to string: {1}{0}", Environment.NewLine, x509.ToString(true));
            Console.WriteLine("{0}Certificate to XML String: {1}{0}", Environment.NewLine, x509.PublicKey.Key.ToXmlString(false));

            //Add the certificate to a X509Store.
            X509Store store = new X509Store();
            store.Open(OpenFlags.MaxAllowed);
            store.Add(x509);
            store.Close();
        }
        catch (DirectoryNotFoundException)
        {
               Console.WriteLine("Error: The directory specified could not be found.");
        }
        catch (IOException)
        {
            Console.WriteLine("Error: A file in the directory could not be accessed.");
        }
        catch (NullReferenceException)
        {
            Console.WriteLine("File must be a .cer file. Program does not have access to that type of file.");
        }
    }
}

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

Class CertInfo

    'Reads a file.
    Friend Shared Function ReadFile(ByVal fileName As String) As Byte()
        Dim f As New FileStream(fileName, FileMode.Open, FileAccess.Read)
        Dim size As Integer = Fix(f.Length)
        Dim data(size - 1) As Byte
        size = f.Read(data, 0, size)
        f.Close()
        Return data

    End Function 

    <SecurityPermission(SecurityAction.LinkDemand, Unrestricted:=True)> _
    Shared Sub Main(ByVal args() As String)
        'Test for correct number of arguments.
        If args.Length < 1 Then
            Console.WriteLine("Usage: CertInfo <filename>")
            Return
        End If
        Try
            Dim x509 As New X509Certificate2()
            'Create X509Certificate2 object from .cer file.
            Dim rawData As Byte() = ReadFile(args(0))
            
            x509.Import(rawData)

            'Print to console information contained in the certificate.
            Console.WriteLine("{0}Subject: {1}{0}", Environment.NewLine, x509.Subject)
            Console.WriteLine("{0}Issuer: {1}{0}", Environment.NewLine, x509.Issuer)
            Console.WriteLine("{0}Version: {1}{0}", Environment.NewLine, x509.Version)
            Console.WriteLine("{0}Valid Date: {1}{0}", Environment.NewLine, x509.NotBefore)
            Console.WriteLine("{0}Expiry Date: {1}{0}", Environment.NewLine, x509.NotAfter)
            Console.WriteLine("{0}Thumbprint: {1}{0}", Environment.NewLine, x509.Thumbprint)
            Console.WriteLine("{0}Serial Number: {1}{0}", Environment.NewLine, x509.SerialNumber)
            Console.WriteLine("{0}Friendly Name: {1}{0}", Environment.NewLine, x509.PublicKey.Oid.FriendlyName)
            Console.WriteLine("{0}Public Key Format: {1}{0}", Environment.NewLine, x509.PublicKey.EncodedKeyValue.Format(True))
            Console.WriteLine("{0}Raw Data Length: {1}{0}", Environment.NewLine, x509.RawData.Length)
            Console.WriteLine("{0}Certificate to string: {1}{0}", Environment.NewLine, x509.ToString(True))

            Console.WriteLine("{0}Certificate to XML String: {1}{0}", Environment.NewLine, x509.PublicKey.Key.ToXmlString(False))

            'Add the certificate to a X509Store.
            Dim store As New X509Store()
            store.Open(OpenFlags.MaxAllowed)
            store.Add(x509)
            store.Close()

        Catch dnfExcept As DirectoryNotFoundException
            Console.WriteLine("Error: The directory specified could not be found.")
        Catch ioExpcept As IOException
            Console.WriteLine("Error: A file in the directory could not be accessed.")
        Catch nrExcept As NullReferenceException
            Console.WriteLine("File must be a .cer file. Program does not have access to that type of file.")
        End Try

    End Sub
End Class

Remarques

Cette méthode peut être utilisée pour remplir un objet à l’aide d’un X509Certificate2 mot de passe pour le certificat représenté par le tableau d’octets. La X509KeyStorageFlags valeur peut être utilisée pour contrôler où et comment importer la clé privée.

Cette méthode accepte un tableau d’octets et peut être utilisée pour les types de certificats tels que les certificats X.509 encodés en base64 ou ENR ou les certificats PFX/PKCS12. Notez qu’un certificat PFX/PKCS12 peut contenir plusieurs certificats. Dans ce cas, le premier certificat associé à une clé privée est utilisé ou, si aucune clé privée n’est trouvée, le premier certificat est utilisé.

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.

Import(String, SecureString, X509KeyStorageFlags)

Source:

X509Certificate2.cs

Attention

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

Important

Cette API n’est pas conforme CLS.

Remplit un objet X509Certificate2 avec les informations d'un fichier de certificat, d'un mot de passe et d'un indicateur de stockage de clé.

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

[System.CLSCompliant(false)]
[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 override void Import (string fileName, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[<System.CLSCompliant(false)>]
[<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}")>]
override this.Import : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit

Public Overrides Sub Import (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 ObsoleteAttribute

Remarques

Note de sécurité 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.

Import(String, String, X509KeyStorageFlags)

Source:

X509Certificate2.cs

Attention

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

Remplit l'objet X509Certificate2 avec des informations venant d'un fichier de certificat, un mot de passe et une valeur X509KeyStorageFlags.

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

[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 override void Import (string fileName, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[<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}")>]
override this.Import : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit

Public Overrides Sub Import (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

ObsoleteAttribute

Remarques

Cette méthode peut être utilisée pour remplir un X509Certificate2 objet avec des informations provenant d’un fichier de certificat, d’un mot de passe et d’une X509KeyStorageFlags valeur.

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.