X509Certificate Klasse

Definition

Stellt Methoden bereit, die Sie beim Verwenden von X.509-Zertifikaten (v.3) unterstützen.

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
Vererbung
X509Certificate
Abgeleitet
Attribute
Implementiert

Beispiele

Im folgenden Beispiel wird ein X.509-Zertifikat aus einer Datei geladen, die ToString -Methode aufgerufen und die Ergebnisse in der Konsole angezeigt.

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

Hinweise

ASN.1 DER ist das einzige Zertifikatformat, das von dieser Klasse unterstützt wird.

In den meisten Szenarien sollten Sie stattdessen die X509Certificate2 -Klasse verwenden.

Wichtig

Ab dem .NET Framework 4.6 implementiert dieser Typ die IDisposable Schnittstelle. Nach Abschluss der Verwendung sollten Sie den Typ entweder direkt oder indirekt löschen. Zum direkten Löschen des Typs rufen Sie seine Dispose-Methode in einem try/catch-Block auf. Zum indirekten Löschen verwenden Sie ein Sprachkonstrukt wie using (in C#) oder Using (in Visual Basic). Weitere Informationen finden Sie im Abschnitt „Verwenden eines Objekts, das IDisposable implementiert“ des Themas „Die IDisposable-Schnittstelle“.

Für Apps, die auf die .NET Framework 4.5.2 und frühere Versionen abzielen, implementiert die X509Certificate -Klasse die IDisposable Schnittstelle nicht und verfügt Dispose daher über keine -Methode.

Konstruktoren

X509Certificate()
Veraltet.

Initialisiert eine neue Instanz der X509Certificate-Klasse.

X509Certificate(Byte[])

Initialisiert eine neue Instanz der X509Certificate-Klasse, die aus einer Folge von Bytes zum Darstellen eines X.509v3-Zertifikats definiert ist.

X509Certificate(Byte[], SecureString)

Initialisiert eine neue Instanz der X509Certificate-Klasse mit einem Bytearray und einem Kennwort.

X509Certificate(Byte[], SecureString, X509KeyStorageFlags)

Initialisiert eine neue Instanz der X509Certificate-Klasse mit einem Bytearray, einem Kennwort und einem Schlüsselspeicherflag.

X509Certificate(Byte[], String)

Initialisiert eine neue Instanz der X509Certificate-Klasse mit einem Bytearray und einem Kennwort.

X509Certificate(Byte[], String, X509KeyStorageFlags)

Initialisiert eine neue Instanz der X509Certificate-Klasse mit einem Bytearray, einem Kennwort und einem Schlüsselspeicherflag.

X509Certificate(IntPtr)

Initialisiert mithilfe eines Handles für eine nicht verwaltete X509Certificate-Struktur eine neue Instanz der PCCERT_CONTEXT-Klasse.

X509Certificate(SerializationInfo, StreamingContext)

Initialisiert eine neue Instanz der X509Certificate-Klasse mithilfe eines SerializationInfo-Objekts und einer StreamingContext-Struktur.

X509Certificate(String)

Initialisiert eine neue Instanz der X509Certificate-Klasse mit dem Namen einer mit PKCS7 signierten Datei.

X509Certificate(String, SecureString)

Initialisiert mithilfe eines Zertifikatsdateinamens und eines Kennworts eine neue Instanz der X509Certificate-Klasse.

X509Certificate(String, SecureString, X509KeyStorageFlags)

Initialisiert mithilfe eines Zertifikatsdateinamens, eines Kennworts und eines Schlüsselspeicherflags eine neue Instanz der X509Certificate-Klasse.

X509Certificate(String, String)

Initialisiert eine neue Instanz der X509Certificate-Klasse mit dem Namen einer mit PKCS7 signierten Datei und einem Kennwort für den Zugriff auf das Zertifikat.

X509Certificate(String, String, X509KeyStorageFlags)

Initialisiert eine neue Instanz der X509Certificate-Klasse mit dem Namen einer mit PKCS7 signierten Datei, einem Kennwort für den Zugriff auf das Zertifikat und einem Schlüsselspeicherflag.

X509Certificate(X509Certificate)

Initialisiert eine neue Instanz der X509Certificate-Klasse unter Verwendung einer anderen X509Certificate-Klasse.

Eigenschaften

Handle

Ruft ein Handle für einen von einer nicht verwalteten PCCERT_CONTEXT-Struktur beschriebenen Microsoft Cryptographic API-Zertifikatskontext ab.

Issuer

Ruft den Namen der Zertifizierungsstelle ab, die das X.509-Zertifikat (v.3) ausgestellt hat.

SerialNumberBytes

Ruft die Big-End-Darstellung der Seriennummer des Zertifikats ab.

Subject

Ruft den Distinguished Name für den Antragsteller aus dem Zertifikat ab.

Methoden

CreateFromCertFile(String)

Erstellt aus der angegebenen mit PKCS7 signierten Datei ein X.509-Zertifikat (v.3).

CreateFromSignedFile(String)

Erstellt aus der angegebenen signierten Datei ein X.509-Zertifikat (v.3).

Dispose()

Gibt alle vom aktuellen X509Certificate-Objekt verwendeten Ressourcen frei.

Dispose(Boolean)

Gibt alle von dieser X509Certificate verwendeten nicht verwalteten Ressourcen und optional auch die verwalteten Ressourcen frei.

Equals(Object)

Überprüft zwei X509Certificate-Objekte auf Gleichheit.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
Equals(X509Certificate)

Überprüft zwei X509Certificate-Objekte auf Gleichheit.

Export(X509ContentType)

Exportiert das aktuelle X509Certificate-Objekt in einem durch einen der X509ContentType-Werte beschriebenen Format in ein Bytearray.

Export(X509ContentType, SecureString)

Exportiert das aktuelle X509Certificate-Objekt mit dem angegebenen Format und einem Kennwort in ein Bytearray.

Export(X509ContentType, String)

Exportiert das aktuelle X509Certificate-Objekt in einem durch einen der X509ContentType-Werte beschriebenen Format mithilfe des angegebenen Kennworts in ein Bytearray.

FormatDate(DateTime)

Konvertiert das angegebene Datum und die Uhrzeit in eine Zeichenfolge.

GetCertHash()

Gibt den Hashwert für das X.509-Zertifikat (v.3) als Bytearray zurück.

GetCertHash(HashAlgorithmName)

Gibt den Hashwert für das X.509v3-Zertifikat zurück, das mit dem angegebenen kryptografischen Hashalgorithmus berechnet wird.

GetCertHashString()

Gibt den SHA1-Hashwert des X. 509v3-Zertifikats als hexadezimale Zeichenfolge zurück

GetCertHashString(HashAlgorithmName)

Gibt eine hexadezimale Zeichenfolge zurück, die den Hashwert für das X.509v3-Zertifikat enthält, das mit dem angegebenen kryptografischen Hashalgorithmus berechnet wird.

GetEffectiveDateString()

Gibt das Gültigkeitsdatum dieses X.509-Zertifikats (v.3) zurück.

GetExpirationDateString()

Gibt das Ablaufdatum dieses X.509-Zertifikats (v.3) zurück.

GetFormat()

Gibt den Formatnamen dieses X.509v3-Zertifikats zurück

GetHashCode()

Gibt den Hashcode für das X.509-Zertifikat (v.3) als ganze Zahl zurück.

GetIssuerName()
Veraltet.
Veraltet.
Veraltet.
Veraltet.

Gibt den Namen der Zertifizierungsstelle zurück, die das X.509-Zertifikat (v.3) ausgestellt hat.

GetKeyAlgorithm()

Gibt die Schlüsselalgorithmusinformationen zu diesem X.509v3-Zertifikat als Zeichenfolge zurück

GetKeyAlgorithmParameters()

Gibt die Schlüsselalgorithmusparameter für das X.509v3-Zertifikat als Bytearray zurück.

GetKeyAlgorithmParametersString()

Gibt die Schlüsselalgorithmusparameter für das X.509v3-Zertifikat als hexadezimale Zeichenfolge zurück

GetName()
Veraltet.
Veraltet.
Veraltet.
Veraltet.

Gibt den Namen des Prinzipals zurück, für den das Zertifikat ausgestellt wurde.

GetPublicKey()

Gibt den öffentlichen Schlüssel für das X.509v3-Zertifikat als Bytearray zurück.

GetPublicKeyString()

Gibt den öffentlichen Schlüssel für das X.509v3-Zertifikat als hexadezimale Zeichenfolge zurück.

GetRawCertData()

Gibt die Rohdaten für das gesamte X.509v3-Zertifikat als Bytearray zurück.

GetRawCertDataString()

Gibt die Rohdaten für das gesamte X.509v3-Zertifikat als hexadezimale Zeichenfolge zurück.

GetSerialNumber()

Gibt die Seriennummer des X.509v3-Zertifikats als Bytearray in Little-Endian-Reihenfolge zurück.

GetSerialNumberString()

Gibt die Seriennummer des X.509v3-Zertifikats als hexadezimale Little-Endian-Zeichenfolge zurück.

GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
Import(Byte[])
Veraltet.

Füllt das X509Certificate-Objekt mit Daten aus einem Bytearray auf.

Import(Byte[], SecureString, X509KeyStorageFlags)
Veraltet.

Füllt ein X509Certificate-Objekt mithilfe der Daten aus einem Bytearray, eines Kennworts und eines Schlüsselspeicherflags auf.

Import(Byte[], String, X509KeyStorageFlags)
Veraltet.

Füllt das X509Certificate-Objekt mithilfe der Daten aus einem Bytearray, einem Kennwort und Flags auf, mit denen bestimmt wird, wie der private Schlüssel importiert wird.

Import(String)
Veraltet.

Füllt das X509Certificate-Objekt mit Informationen aus einer Zertifikatsdatei auf.

Import(String, SecureString, X509KeyStorageFlags)
Veraltet.

Füllt ein X509Certificate-Objekt mit Informationen aus einer Zertifikatsdatei, einem Kennwort und einem Schlüsselspeicherflag auf.

Import(String, String, X509KeyStorageFlags)
Veraltet.

Füllt das X509Certificate-Objekt mit Informationen aus einer Zertifikatsdatei, einem Kennwort und einem X509KeyStorageFlags-Wert auf.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
Reset()

Setzt den Zustand des X509Certificate2-Objekts zurück.

ToString()

Gibt eine Zeichenfolgendarstellung des aktuellen X509Certificate-Objekts zurück.

ToString(Boolean)

Gibt eine Zeichenfolgendarstellung des aktuellen X509Certificate-Objekts zurück, optional mit Zusatzinformationen.

TryGetCertHash(HashAlgorithmName, Span<Byte>, Int32)

Versucht, einen „Fingerabdruck“ für das Zertifikat zu erzeugen, indem ein Hash der codierten Darstellung des Zertifikats mit dem angegebenen Hashalgorithmus generiert wird.

Explizite Schnittstellenimplementierungen

IDeserializationCallback.OnDeserialization(Object)

Implementiert die ISerializable-Schnittstelle und wird nach Abschluss der Deserialisierung durch das Deserialisierungsereignis aufgerufen.

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Ruft Serialisierungsinformationen mit allen Daten ab, die für das erneute Erstellen einer Instanz des aktuellen X509Certificate-Objekts erforderlich sind.

Gilt für: