X509Certificate.Import Méthode

Référence

Définition

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

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

Assembly:: System.Security.Cryptography.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Important

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

Remplit un objet X509Certificate.

Surcharges

Import(Byte[])	Obsolète. Remplit l'objet X509Certificate avec les données d'un tableau d'octets.
Import(String)	Obsolète. Remplit l'objet X509Certificate des informations d'un fichier de certificat.
Import(Byte[], SecureString, X509KeyStorageFlags)	Obsolète. Remplit un objet X509Certificate à 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 l'objet X509Certificate à l'aide de données d'un tableau d'octets, d'un mot de passe et d'indicateurs qui déterminent comment la clé privée est importée.
Import(String, SecureString, X509KeyStorageFlags)	Obsolète. Remplit un objet X509Certificate 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 X509Certificate avec des informations venant d'un fichier de certificat, un mot de passe et une valeur X509KeyStorageFlags.

Import(Byte[])

Attention

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

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

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

public virtual 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}")]
public virtual void Import (byte[] rawData);

[System.Runtime.InteropServices.ComVisible(false)]
public virtual void Import (byte[] rawData);

[System.Runtime.InteropServices.ComVisible(false)]
[System.Security.SecurityCritical]
public virtual void Import (byte[] rawData);

abstract member Import : byte[] -> unit
override this.Import : byte[] -> unit

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

[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member Import : byte[] -> unit
override this.Import : byte[] -> unit

[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.Security.SecurityCritical>]
abstract member Import : byte[] -> unit
override this.Import : byte[] -> unit

Public Overridable Sub Import (rawData As Byte())

Paramètres

rawData: Byte[]

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

Attributs: ObsoleteAttribute ComVisibleAttribute SecurityCriticalAttribute

Exceptions

ArgumentException

Le paramètre rawData a la valeur null.

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

PlatformNotSupportedException

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

Remarques

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

S’applique à

Import(String)

Attention

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

Remplit l'objet X509Certificate des informations d'un fichier de certificat.

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

public virtual 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}")]
public virtual void Import (string fileName);

[System.Runtime.InteropServices.ComVisible(false)]
public virtual void Import (string fileName);

[System.Runtime.InteropServices.ComVisible(false)]
[System.Security.SecurityCritical]
public virtual void Import (string fileName);

abstract member Import : string -> unit
override this.Import : string -> unit

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

[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member Import : string -> unit
override this.Import : string -> unit

[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.Security.SecurityCritical>]
abstract member Import : string -> unit
override this.Import : string -> unit

Public Overridable Sub Import (fileName As String)

Paramètres

fileName: String

Nom d'un fichier de certificat représenté par une chaîne.

Attributs: ObsoleteAttribute ComVisibleAttribute SecurityCriticalAttribute

Exceptions

ArgumentException

Le paramètre fileName a la valeur null.

PlatformNotSupportedException

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

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;
   cert->Import(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;

class X509
{

    static void Main()
    {

        // The path to the certificate.
        string Certificate = "Certificate.cer";

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

        cert.Import(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

        cert.Import(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

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 X509Certificate avec le certificat que le fichier contient.

S’applique à

Import(Byte[], SecureString, X509KeyStorageFlags)

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 X509Certificate à l'aide de données d'un tableau d'octets, d'un mot de passe et d'un indicateur de stockage de clé.

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

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

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

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

[System.Security.SecurityCritical]
public virtual void Import (byte[] rawData, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[<System.CLSCompliant(false)>]
abstract member Import : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit
override this.Import : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit

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

abstract member Import : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit
override this.Import : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit

[<System.Security.SecurityCritical>]
abstract member Import : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit
override this.Import : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit

Public Overridable 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 SecurityCriticalAttribute

Exceptions

ArgumentException

Le paramètre rawData a la valeur null.

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

PlatformNotSupportedException

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

Remarques

Important

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

S’applique à

Import(Byte[], String, X509KeyStorageFlags)

Attention

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

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

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

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

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

[System.Runtime.InteropServices.ComVisible(false)]
public virtual void Import (byte[] rawData, string password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[System.Runtime.InteropServices.ComVisible(false)]
[System.Security.SecurityCritical]
public virtual void Import (byte[] rawData, string password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

abstract member Import : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit
override this.Import : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit

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

[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member Import : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit
override this.Import : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit

[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.Security.SecurityCritical>]
abstract member Import : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit
override this.Import : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit

Public Overridable 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 ComVisibleAttribute SecurityCriticalAttribute

Exceptions

ArgumentException

Le paramètre rawData a la valeur null.

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

PlatformNotSupportedException

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

Remarques

Cette méthode peut être utilisée pour remplir un objet à l’aide d’un X509Certificate 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 la clé privée est importée.

S’applique à

Import(String, SecureString, X509KeyStorageFlags)

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 X509Certificate avec les informations d'un fichier de certificat, d'un mot de passe et d'un indicateur de stockage de clé.

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

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

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

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

[System.Security.SecurityCritical]
public virtual void Import (string fileName, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[<System.CLSCompliant(false)>]
abstract member Import : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit
override this.Import : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit

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

abstract member Import : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit
override this.Import : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit

[<System.Security.SecurityCritical>]
abstract member Import : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit
override this.Import : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit

Public Overridable 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 SecurityCriticalAttribute

Exceptions

ArgumentException

Le paramètre fileName a la valeur null.

PlatformNotSupportedException

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

Remarques

Important

S’applique à

Import(String, String, X509KeyStorageFlags)

Attention

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

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

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

public virtual 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}")]
public virtual void Import (string fileName, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

public virtual void Import (string fileName, string password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[System.Runtime.InteropServices.ComVisible(false)]
public virtual void Import (string fileName, string password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[System.Runtime.InteropServices.ComVisible(false)]
[System.Security.SecurityCritical]
public virtual void Import (string fileName, string password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

abstract member Import : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit
override this.Import : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit

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

[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member Import : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit
override this.Import : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit

[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.Security.SecurityCritical>]
abstract member Import : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit
override this.Import : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit

Public Overridable Sub Import (fileName As String, password As String, keyStorageFlags As X509KeyStorageFlags)

Paramètres

fileName: String

Nom d'un fichier de certificat représenté par une chaîne.

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 ComVisibleAttribute SecurityCriticalAttribute

Exceptions

ArgumentException

Le paramètre fileName a la valeur null.

PlatformNotSupportedException

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

Remarques

Important

S’applique à

X509Certificate.Import Méthode

Définition

Surcharges

Import(Byte[])

Paramètres

Exceptions

Remarques

S’applique à

Import(String)

Paramètres

Exceptions

Exemples

Remarques

S’applique à

Import(Byte[], SecureString, X509KeyStorageFlags)

Paramètres

Exceptions

Remarques

S’applique à

Import(Byte[], String, X509KeyStorageFlags)

Paramètres

Exceptions

Remarques

S’applique à

Import(String, SecureString, X509KeyStorageFlags)

Paramètres

Exceptions

Remarques

S’applique à

Import(String, String, X509KeyStorageFlags)

Paramètres

Exceptions

Remarques

S’applique à

Ressources supplémentaires