X509Certificate Klas

Definitie

Naamruimte:
System.Security.Cryptography.X509Certificates
Assembly's:
netstandard.dll, System.Security.Cryptography.dll
Assembly's:
netstandard.dll, System.Security.Cryptography.X509Certificates.dll
Assembly's:
netstandard.dll, System.Security.Cryptography.dll, System.Security.Cryptography.X509Certificates.dll
Assembly:
System.Security.Cryptography.X509Certificates.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Bron:
X509Certificate.cs
Bron:
X509Certificate.cs
Bron:
X509Certificate.cs
Bron:
X509Certificate.cs
Bron:
X509Certificate.cs

Biedt methoden waarmee u X.509 v.3-certificaten kunt gebruiken.

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
Overname
Object
X509Certificate
Afgeleid
Kenmerken
SerializableAttribute ComVisibleAttribute
Implementeringen
IDisposable IDeserializationCallback ISerializable

Voorbeelden

In het volgende voorbeeld wordt een X.509-certificaat uit een bestand geladen, wordt de ToString methode aangeroepen en worden de resultaten weergegeven in de 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

Opmerkingen

ASN.1 DER is de enige certificaatindeling die door deze klasse wordt ondersteund.

Voor de meeste scenario's moet u in plaats daarvan de X509Certificate2 klasse gebruiken.

Important

Vanaf het .NET Framework 4.6 implementeert dit type de interface IDisposable. Wanneer u klaar bent met het gebruik van het type, moet u het direct of indirect verwijderen. Als u het type rechtstreeks wilt verwijderen, roept u de Dispose methode aan in een try/catch blok. Als u deze indirect wilt verwijderen, gebruikt u een taalconstructie zoals using (in C#) of Using (in Visual Basic). Zie de sectie 'Using an Object that Implements IDisposable' (Een object gebruiken dat IDisposable implementeert) in het IDisposable interfaceonderwerp voor meer informatie.

Voor apps die zijn gericht op het .NET Framework 4.5.2 en eerdere versies, implementeert de klasse X509Certificate de interface IDisposable niet en heeft daarom geen methode Dispose.

Constructors

Name Description
X509Certificate()
Verouderd.
Verouderd.

Initialiseert een nieuw exemplaar van de X509Certificate klasse.
X509Certificate(Byte[], SecureString, X509KeyStorageFlags)
Verouderd.

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van een bytematrix, een wachtwoord en een vlag voor sleutelopslag.
X509Certificate(Byte[], SecureString)
Verouderd.

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van een bytematrix en een wachtwoord.
X509Certificate(Byte[], String, X509KeyStorageFlags)
Verouderd.

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van een bytematrix, een wachtwoord en een vlag voor sleutelopslag.
X509Certificate(Byte[], String)
Verouderd.

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van een bytematrix en een wachtwoord.
X509Certificate(Byte[])
Verouderd.

Initialiseert een nieuw exemplaar van de X509Certificate klasse die is gedefinieerd op basis van een reeks bytes die een X.509v3-certificaat vertegenwoordigt.
X509Certificate(IntPtr)

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van een ingang naar een niet-beheerde PCCERT_CONTEXT structuur.
X509Certificate(SerializationInfo, StreamingContext)
Verouderd.

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van een SerializationInfo object en een StreamingContext structuur.
X509Certificate(String, SecureString, X509KeyStorageFlags)
Verouderd.

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van een certificaatbestandsnaam, een wachtwoord en een vlag voor sleutelopslag.
X509Certificate(String, SecureString)
Verouderd.

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van een certificaatbestandsnaam en een wachtwoord.
X509Certificate(String, String, X509KeyStorageFlags)
Verouderd.

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van de naam van een PKCS7-ondertekend bestand, een wachtwoord voor toegang tot het certificaat en een vlag voor sleutelopslag.
X509Certificate(String, String)
Verouderd.

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van de naam van een PKCS7-ondertekend bestand en een wachtwoord voor toegang tot het certificaat.
X509Certificate(String)
Verouderd.

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van de naam van een PKCS7-ondertekend bestand.
X509Certificate(X509Certificate)

Initialiseert een nieuw exemplaar van de X509Certificate klasse met behulp van een andere X509Certificate klasse.

Eigenschappen

Name Description
Handle

Hiermee haalt u een ingang op voor een Microsoft Cryptografische API-certificaatcontext die wordt beschreven door een niet-beheerde PCCERT_CONTEXT structuur.
Issuer

Hiermee haalt u de naam op van de certificeringsinstantie die het X.509v3-certificaat heeft uitgegeven.
SerialNumberBytes

Hiermee haalt u de big-endian-weergave van het serienummer van het certificaat op.
Subject

Hiermee haalt u de DN-naam van het onderwerp op van het certificaat.

Methoden

Name Description
CreateFromCertFile(String)
Verouderd.

Hiermee maakt u een X.509v3-certificaat op basis van het opgegeven pkCS7-ondertekende bestand.
CreateFromSignedFile(String)
Verouderd.

Hiermee maakt u een X.509v3-certificaat op basis van het opgegeven ondertekende bestand.
Dispose()

Alle resources die door het huidige X509Certificate object worden gebruikt, worden vrijgegeven.
Dispose(Boolean)

Hiermee worden alle niet-beheerde resources uitgebracht die door deze X509Certificate resource worden gebruikt en worden de beheerde resources optioneel vrijgegeven.
Equals(Object)

Vergelijkt twee X509Certificate objecten voor gelijkheid.
Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
Equals(X509Certificate)

Vergelijkt twee X509Certificate objecten voor gelijkheid.
Export(X509ContentType, SecureString)

Hiermee exporteert u het huidige X509Certificate object naar een bytematrix met behulp van de opgegeven indeling en een wachtwoord.
Export(X509ContentType, String)

Hiermee exporteert u het huidige X509Certificate object naar een bytematrix in een indeling die wordt beschreven door een van de X509ContentType waarden en gebruikt u het opgegeven wachtwoord.
Export(X509ContentType)

Hiermee exporteert u het huidige X509Certificate object naar een bytematrix in een indeling die wordt beschreven door een van de X509ContentType waarden.
ExportPkcs12(PbeParameters, String)

Hiermee exporteert u het certificaat en de persoonlijke sleutel in PKCS#12/PFX-indeling.
ExportPkcs12(Pkcs12ExportPbeParameters, String)

Hiermee exporteert u het certificaat en de persoonlijke sleutel in PKCS#12/PFX-indeling.
FormatDate(DateTime)

Converteert de opgegeven datum en tijd naar een tekenreeks.
GetCertHash()

Retourneert de hash-waarde voor het X.509v3-certificaat als een matrix van bytes.
GetCertHash(HashAlgorithmName)

Retourneert de hash-waarde voor het X.509v3-certificaat dat wordt berekend met behulp van het opgegeven cryptografische hash-algoritme.
GetCertHashString()

Retourneert de SHA-1-hashwaarde voor het X.509v3-certificaat als een hexadecimale tekenreeks.
GetCertHashString(HashAlgorithmName)

Retourneert een hexadecimale tekenreeks met de hash-waarde voor het X.509v3-certificaat dat is berekend met behulp van het opgegeven cryptografische hash-algoritme.
GetEffectiveDateString()

Retourneert de ingangsdatum van dit X.509v3-certificaat.
GetExpirationDateString()

Retourneert de vervaldatum van dit X.509v3-certificaat.
GetFormat()

Retourneert de naam van de indeling van dit X.509v3-certificaat.
GetHashCode()

Retourneert de hash-code voor het X.509v3-certificaat als een geheel getal.
GetIssuerName()
Verouderd.
Verouderd.
Verouderd.

Retourneert de naam van de certificeringsinstantie die het X.509v3-certificaat heeft uitgegeven.
GetKeyAlgorithm()

Retourneert de sleutelalgoritmen voor dit X.509v3-certificaat als een tekenreeks.
GetKeyAlgorithmParameters()

Retourneert de sleutelalgoritmen voor het X.509v3-certificaat als een matrix van bytes.
GetKeyAlgorithmParametersString()

Retourneert de sleutelalgoritmeparameters voor het X.509v3-certificaat als een hexadecimale tekenreeks.
GetName()
Verouderd.
Verouderd.
Verouderd.

Retourneert de naam van de principal waaraan het certificaat is uitgegeven.
GetPublicKey()

Retourneert de openbare sleutel voor het X.509v3-certificaat als een matrix van bytes.
GetPublicKeyString()

Retourneert de openbare sleutel voor het X.509v3-certificaat als een hexadecimale tekenreeks.
GetRawCertData()

Retourneert de onbewerkte gegevens voor het hele X.509v3-certificaat als matrix van bytes.
GetRawCertDataString()

Retourneert de onbewerkte gegevens voor het hele X.509v3-certificaat als een hexadecimale tekenreeks.
GetSerialNumber()

Retourneert het serienummer van het X.509v3-certificaat als een matrix van bytes in little-endian-volgorde.
GetSerialNumberString()

Retourneert het serienummer van het X.509v3-certificaat als een big-endian hexadecimale tekenreeks.
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
Import(Byte[], SecureString, X509KeyStorageFlags)
Verouderd.
Verouderd.

Hiermee wordt een X509Certificate object gevuld met behulp van gegevens uit een bytematrix, een wachtwoord en een sleutelopslagvlag.
Import(Byte[], String, X509KeyStorageFlags)
Verouderd.
Verouderd.

Hiermee wordt het X509Certificate object gevuld met behulp van gegevens uit een bytematrix, een wachtwoord en vlaggen om te bepalen hoe de persoonlijke sleutel wordt geïmporteerd.
Import(Byte[])
Verouderd.
Verouderd.

Hiermee wordt het X509Certificate object gevuld met gegevens uit een bytematrix.
Import(String, SecureString, X509KeyStorageFlags)
Verouderd.
Verouderd.

Hiermee wordt een X509Certificate object gevuld met informatie uit een certificaatbestand, een wachtwoord en een sleutelopslagvlag.
Import(String, String, X509KeyStorageFlags)
Verouderd.
Verouderd.

Hiermee wordt het X509Certificate object gevuld met informatie uit een certificaatbestand, een wachtwoord en een X509KeyStorageFlags waarde.
Import(String)
Verouderd.
Verouderd.

Hiermee wordt het X509Certificate object gevuld met informatie uit een certificaatbestand.
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
Reset()

Hiermee stelt u de status van het X509Certificate2 object opnieuw in.
ToString()

Retourneert een tekenreeksweergave van het huidige X509Certificate object.
ToString(Boolean)

Retourneert een tekenreeksweergave van het huidige X509Certificate object, met extra informatie, indien opgegeven.
TryGetCertHash(HashAlgorithmName, Span<Byte>, Int32)

Probeert een 'vingerafdruk' voor het certificaat te produceren door de gecodeerde weergave van het certificaat te hashen met het opgegeven hash-algoritme.

Expliciete interface-implementaties

Name Description
IDeserializationCallback.OnDeserialization(Object)

Implementeert de ISerializable interface en wordt teruggeroepen door de deserialisatie-gebeurtenis wanneer deserialisatie is voltooid.
ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Hiermee haalt u serialisatie-informatie op met alle gegevens die nodig zijn om een exemplaar van het huidige X509Certificate object opnieuw te maken.

Van toepassing op