X509Certificate Classe

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.

Fournit des méthodes destinées à vous aider à utiliser des certificats X.509 v.3.

public ref class X509Certificate : IDisposable, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable

public ref class X509Certificate : IDisposable

public ref class X509Certificate

public ref class X509Certificate : System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable

public class X509Certificate : IDisposable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable

public class X509Certificate : IDisposable

[System.Serializable]
public class X509Certificate

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class X509Certificate : System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class X509Certificate : IDisposable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable

type X509Certificate = class
    interface IDisposable
    interface IDeserializationCallback
    interface ISerializable

type X509Certificate = class
    interface IDisposable

type X509Certificate = class
    interface IDisposable
    interface ISerializable
    interface IDeserializationCallback

[<System.Serializable>]
type X509Certificate = class

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type X509Certificate = class
    interface IDeserializationCallback
    interface ISerializable

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type X509Certificate = class
    interface IDisposable
    interface IDeserializationCallback
    interface ISerializable

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type X509Certificate = class
    interface IDeserializationCallback
    interface ISerializable
    interface IDisposable

Public Class X509Certificate
Implements IDeserializationCallback, IDisposable, ISerializable

Public Class X509Certificate
Implements IDisposable

Public Class X509Certificate

Public Class X509Certificate
Implements IDeserializationCallback, ISerializable

Héritage: Object
X509Certificate

Dérivé: System.Security.Cryptography.X509Certificates.X509Certificate2

Attributs: SerializableAttribute ComVisibleAttribute

Implémente: IDisposable IDeserializationCallback ISerializable

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.

Pour la plupart des scénarios, vous devez utiliser la classe à la X509Certificate2 place.

Important

À compter du .NET Framework 4.6, ce type implémente l’interfaceIDisposable. Une fois que vous avez fini d’utiliser le type, vous devez le supprimer directement ou indirectement. Pour supprimer directement le type Dispose, appelez sa méthode dans un bloc try/catch. Pour la supprimer indirectement, utilisez une construction de langage telle que using (dans C#) ou Using (dans Visual Basic). Pour plus d’informations, consultez la section « Utilisation d’un objet qui implémente IDisposable » dans la rubrique de l’interface IDisposable.

Pour les applications qui ciblent les versions .NET Framework 4.5.2 et antérieures, la X509Certificate classe n’implémente pas l’interface IDisposable et n’a donc pas de Dispose méthode.

Constructeurs

X509Certificate()	Obsolète. Initialise une nouvelle instance de la classe X509Certificate.
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[], SecureString)	Initialise une nouvelle instance de la classe X509Certificate à l'aide d'un tableau d'octets et d'un mot de passe.
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(Byte[], String)	Initialise une nouvelle instance de la classe X509Certificate à l'aide d'un tableau d'octets et d'un mot de passe.
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(IntPtr)	Initialise une nouvelle instance de la classe X509Certificate à l'aide d'un handle vers une structure `PCCERT_CONTEXT` non managée.
X509Certificate(SerializationInfo, StreamingContext)	Initialise une nouvelle instance de la classe X509Certificate à l'aide d'un objet SerializationInfo et d'une structure StreamingContext.
X509Certificate(String)	Initialise une nouvelle instance de la classe X509Certificate en utilisant le nom d'un fichier PKCS7 signé.
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(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(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, 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(X509Certificate)	Initialise une nouvelle instance de la classe X509Certificate avec une autre classe X509Certificate.

Propriétés

Handle	Obtient un handle vers un contexte de certificat Microsoft Cryptographic API décrit par une structure `PCCERT_CONTEXT` non managée.
Issuer	Obtient le nom de l'autorité de certification qui a émis le certificat X.509v.3.
Subject	Obtient le nom unique de l'objet à partir du certificat.

Méthodes

CreateFromCertFile(String)	Crée un certificat X.509v.3 à partir du fichier PKCS7 signé spécifié.
CreateFromSignedFile(String)	Crée un certificat X.509v.3 à partir du fichier signé spécifié.
Dispose()	Libère toutes les ressources utilisées par l’objet X509Certificate actuel.
Dispose(Boolean)	Libère toutes les ressources non managées utilisées par X509Certificate et libère éventuellement les ressources managées.
Equals(Object)	Compare deux objets X509Certificate pour déterminer s’ils sont égaux.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
Equals(X509Certificate)	Compare deux objets X509Certificate pour déterminer s’ils sont égaux.
Export(X509ContentType)	Exporte l'objet X509Certificate en cours dans un tableau d'octets dans un format décrit par l'une des valeurs X509ContentType.
Export(X509ContentType, SecureString)	Exporte l'objet X509Certificate en cours dans un tableau d'octets à l'aide du format spécifié et d'un mot de passe.
Export(X509ContentType, String)	Exporte l'objet X509Certificate en cours dans un tableau d'octets dans un format décrit par l'une des valeurs X509ContentType, et à l'aide du mot de passe spécifié.
FormatDate(DateTime)	Convertit la date et l'heure spécifiées en chaîne.
GetCertHash()	Retourne la valeur de hachage pour le certificat X.509v.3 sous forme de tableau d'octets.
GetCertHash(HashAlgorithmName)	Retourne la valeur de hachage pour le certificat X.509v3 qui est calculée à l’aide de l’algorithme de hachage de chiffrement spécifié.
GetCertHashString()	Retourne la valeur de hachage SHA1 du certificat x.509v.3 sous forme de chaîne hexadécimale.
GetCertHashString(HashAlgorithmName)	Retourne une chaîne hexadécimale contenant la valeur de hachage pour le certificat X.509v3 calculée à l’aide de l’algorithme de hachage de chiffrement spécifié.
GetEffectiveDateString()	Retourne la date d'effet de ce certificat X.509v3.
GetExpirationDateString()	Retourne la date d'expiration de ce certificat X.509v3.
GetFormat()	Retourne le nom du format de ce certificat X.509v3.
GetHashCode()	Retourne le code de hachage du certificat X.509v.3 sous forme d'un entier.
GetIssuerName()	Obsolète. Obsolète. Obsolète. Obsolète. Retourne le nom de l'autorité de certification qui a émis le certificat X.509v.3.
GetKeyAlgorithm()	Retourne les informations d’algorithme de clé du certificat x.509v.3 sous forme de chaîne.
GetKeyAlgorithmParameters()	Retourne les paramètres d'algorithme de clé pour le certificat X.509v3 sous forme de tableau d'octets.
GetKeyAlgorithmParametersString()	Retourne les paramètres d’algorithme de clé du certificat x.509v.3 sous forme de chaîne hexadécimale.
GetName()	Obsolète. Obsolète. Obsolète. Obsolète. Retourne le nom de l'entité de sécurité pour laquelle le certificat a été émis.
GetPublicKey()	Retourne la clé publique pour le certificat X.509v3 sous forme de tableau d'octets.
GetPublicKeyString()	Retourne la clé publique pour le certificat X.509v3 sous forme de chaîne hexadécimale.
GetRawCertData()	Retourne les données brutes de la totalité du certificat X.509v.3 sous forme de tableau d'octets.
GetRawCertDataString()	Retourne les données brutes de la totalité du certificat X.509v.3 sous forme de chaîne hexadécimale.
GetSerialNumber()	Retourne le numéro de série du certificat X.509v3 sous forme de tableau d’octets dans l’ordre Little Endian.
GetSerialNumberString()	Retourne le numéro de série du certificat X.509v3 sous forme de chaîne hexadécimale Little Endian.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
Import(Byte[])	Obsolète. Remplit l'objet X509Certificate avec les données d'un tableau d'octets.
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)	Obsolète. Remplit l'objet X509Certificate des informations d'un fichier de certificat.
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.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Reset()	Réinitialise l'état de l'objet X509Certificate2.
ToString()	Retourne une chaîne représentant l'objet X509Certificate en cours.
ToString(Boolean)	Retourne une chaîne représentant l'objet X509Certificate en cours, avec des informations supplémentaires, si elles sont spécifiées.
TryGetCertHash(HashAlgorithmName, Span<Byte>, Int32)	Tente de produire une « empreinte numérique » pour le certificat en hachant la représentation encodée du certificat avec l’algorithme de hachage spécifié.

Implémentations d’interfaces explicites

IDeserializationCallback.OnDeserialization(Object)	Implémente l’interface ISerializable et est rappelé par l’événement de désérialisation quand la désérialisation est terminée.
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Obtient des informations de sérialisation avec toutes les données nécessaires à la recréation d'une instance de l'objet X509Certificate en cours.

S’applique à