X509Certificate Classe

Définition

Espace de noms:
System.Security.Cryptography.X509Certificates
Assemblys:
netstandard.dll, System.Security.Cryptography.dll
Assemblys:
netstandard.dll, System.Security.Cryptography.X509Certificates.dll
Assemblys:
netstandard.dll, System.Security.Cryptography.dll, System.Security.Cryptography.X509Certificates.dll
Assembly:
System.Security.Cryptography.X509Certificates.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Source:
X509Certificate.cs
Source:
X509Certificate.cs
Source:
X509Certificate.cs
Source:
X509Certificate.cs
Source:
X509Certificate.cs

Fournit des méthodes qui vous aident à 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
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é
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 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’interface IDisposable . Une fois que vous avez fini d’utiliser le type, vous devez le supprimer directement ou indirectement. Pour supprimer directement le type, appelez sa Dispose méthode dans un try/catch bloc. Pour la supprimer indirectement, utilisez une construction de langage telle que using (en C#) ou Using (en Visual Basic). Pour plus d’informations, consultez la section « Utilisation d’un objet implémentant IDisposable » dans la rubrique d’interface IDisposable .

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

Constructeurs

Nom Description
X509Certificate()
Obsolète.
Obsolète.

Initialise une nouvelle instance de la classe X509Certificate.
X509Certificate(Byte[], SecureString, X509KeyStorageFlags)
Obsolète.

Initialise une nouvelle instance de la classe à l’aide X509Certificate d’un tableau d’octets, d’un mot de passe et d’un indicateur de stockage de clé.
X509Certificate(Byte[], SecureString)
Obsolète.

Initialise une nouvelle instance de la classe à l’aide X509Certificate d’un tableau d’octets et d’un mot de passe.
X509Certificate(Byte[], String, X509KeyStorageFlags)
Obsolète.

Initialise une nouvelle instance de la classe à l’aide X509Certificate d’un tableau d’octets, d’un mot de passe et d’un indicateur de stockage de clé.
X509Certificate(Byte[], String)
Obsolète.

Initialise une nouvelle instance de la classe à l’aide X509Certificate d’un tableau d’octets et d’un mot de passe.
X509Certificate(Byte[])
Obsolète.

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

Initialise une nouvelle instance de la classe à l’aide X509Certificate d’un handle vers une structure non managée PCCERT_CONTEXT .
X509Certificate(SerializationInfo, StreamingContext)
Obsolète.

Initialise une nouvelle instance de la classe à l’aide X509Certificate d’un objet et d’une SerializationInfoStreamingContext structure.
X509Certificate(String, SecureString, X509KeyStorageFlags)
Obsolète.

Initialise une nouvelle instance de la classe à l’aide X509Certificate d’un nom de fichier de certificat, d’un mot de passe et d’un indicateur de stockage de clé.
X509Certificate(String, SecureString)
Obsolète.

Initialise une nouvelle instance de la classe à l’aide X509Certificate d’un nom de fichier de certificat et d’un mot de passe.
X509Certificate(String, String, X509KeyStorageFlags)
Obsolète.

Initialise une nouvelle instance de la X509Certificate classe à l’aide du nom d’un fichier signé PKCS7, d’un mot de passe pour accéder au certificat et d’un indicateur de stockage de clé.
X509Certificate(String, String)
Obsolète.

Initialise une nouvelle instance de la X509Certificate classe à l’aide du nom d’un fichier signé PKCS7 et d’un mot de passe pour accéder au certificat.
X509Certificate(String)
Obsolète.

Initialise une nouvelle instance de la classe à l’aide X509Certificate du nom d’un fichier signé PKCS7.
X509Certificate(X509Certificate)

Initialise une nouvelle instance de la classe à l’aide X509Certificate d’une autre X509Certificate classe.

Propriétés

Nom Description
Handle

Obtient un handle vers un contexte de certificat d’API de chiffrement Microsoft décrit par une structure non managée PCCERT_CONTEXT .
Issuer

Obtient le nom de l’autorité de certification qui a émis le certificat X.509v3.
SerialNumberBytes

Obtient la représentation big-endian du numéro de série du certificat.
Subject

Obtient le nom unique de l’objet du certificat.

Méthodes

Nom Description
CreateFromCertFile(String)
Obsolète.

Crée un certificat X.509v3 à partir du fichier signé PKCS7 spécifié.
CreateFromSignedFile(String)
Obsolète.

Crée un certificat X.509v3 à partir du fichier signé spécifié.
Dispose()

Libère toutes les ressources utilisées par l’objet actuel X509Certificate .
Dispose(Boolean)

Libère toutes les ressources non managées utilisées par cela 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, SecureString)

Exporte l’objet actuel X509Certificate vers un tableau d’octets à l’aide du format spécifié et d’un mot de passe.
Export(X509ContentType, String)

Exporte l’objet actuel X509Certificate dans un tableau d’octets dans un format décrit par l’une X509ContentType des valeurs et à l’aide du mot de passe spécifié.
Export(X509ContentType)

Exporte l’objet actuel X509Certificate vers un tableau d’octets dans un format décrit par l’une X509ContentType des valeurs.
ExportPkcs12(PbeParameters, String)

Exporte le certificat et la clé privée au format PKCS#12 / PFX.
ExportPkcs12(Pkcs12ExportPbeParameters, String)

Exporte le certificat et la clé privée au format PKCS#12 / PFX.
FormatDate(DateTime)

Convertit la date et l’heure spécifiées en chaîne.
GetCertHash()

Retourne la valeur de hachage du certificat X.509v3 sous la forme d’un tableau d’octets.
GetCertHash(HashAlgorithmName)

Retourne la valeur de hachage pour le certificat X.509v3 calculé à l’aide de l’algorithme de hachage de chiffrement spécifié.
GetCertHashString()

Retourne la valeur de hachage SHA-1 pour le certificat X.509v3 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é à 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.509v3 sous forme d’entier.
GetIssuerName()
Obsolète.
Obsolète.
Obsolète.

Retourne le nom de l’autorité de certification qui a émis le certificat X.509v3.
GetKeyAlgorithm()

Retourne les informations d’algorithme de clé pour ce certificat X.509v3 sous forme de chaîne.
GetKeyAlgorithmParameters()

Retourne les paramètres d’algorithme de clé pour le certificat X.509v3 sous la forme d’un tableau d’octets.
GetKeyAlgorithmParametersString()

Retourne les paramètres d’algorithme de clé pour le certificat X.509v3 sous forme de chaîne hexadécimale.
GetName()
Obsolète.
Obsolète.
Obsolète.

Retourne le nom du principal auquel le certificat a été émis.
GetPublicKey()

Retourne la clé publique pour le certificat X.509v3 sous la forme d’un 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 pour l’intégralité du certificat X.509v3 sous la forme d’un tableau d’octets.
GetRawCertDataString()

Retourne les données brutes pour l’intégralité du certificat X.509v3 sous forme de chaîne hexadécimale.
GetSerialNumber()

Retourne le numéro de série du certificat X.509v3 sous la forme d’un tableau d’octets dans l’ordre de petite finienne.
GetSerialNumberString()

Retourne le numéro de série du certificat X.509v3 sous forme de chaîne hexadécimale big-endian.
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
Import(Byte[], SecureString, X509KeyStorageFlags)
Obsolète.
Obsolète.

Remplit un X509Certificate objet à l’aide de données à partir d’un tableau d’octets, d’un mot de passe et d’un indicateur de stockage de clé.
Import(Byte[], String, X509KeyStorageFlags)
Obsolète.
Obsolète.

Remplit l’objet X509Certificate à l’aide de données à partir d’un tableau d’octets, d’un mot de passe et d’indicateurs pour déterminer comment la clé privée est importée.
Import(Byte[])
Obsolète.
Obsolète.

Remplit l’objet X509Certificate avec des données d’un tableau d’octets.
Import(String, SecureString, X509KeyStorageFlags)
Obsolète.
Obsolète.

Remplit un X509Certificate objet avec des informations à partir d’un fichier de certificat, d’un mot de passe et d’un indicateur de stockage de clé.
Import(String, String, X509KeyStorageFlags)
Obsolète.
Obsolète.

Remplit l’objet X509Certificate avec des informations à partir d’un fichier de certificat, d’un mot de passe et d’une X509KeyStorageFlags valeur.
Import(String)
Obsolète.
Obsolète.

Remplit l’objet X509Certificate avec des informations à partir d’un fichier de certificat.
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
Reset()

Réinitialise l’état de l’objet X509Certificate2 .
ToString()

Retourne une représentation sous forme de chaîne de l’objet actif X509Certificate .
ToString(Boolean)

Retourne une représentation sous forme de chaîne de l’objet actuel X509Certificate , avec des informations supplémentaires, le cas échéant.
TryGetCertHash(HashAlgorithmName, Span<Byte>, Int32)

Tente de produire une « empreinte » pour le certificat en hachage de la représentation encodée du certificat avec l’algorithme de hachage spécifié.

Implémentations d’interfaces explicites

Nom Description
IDeserializationCallback.OnDeserialization(Object)

Implémente l’interface ISerializable et est rappelée par l’événement de désérialisation lorsque la désérialisation est terminée.
ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Obtient des informations de sérialisation avec toutes les données nécessaires pour recréer une instance de l’objet actuel X509Certificate .

S’applique à