X509Certificate Klass

Definition

Namnområde:
System.Security.Cryptography.X509Certificates
Sammansättning:
mscorlib.dll
Sammansättning:
System.Security.Cryptography.X509Certificates.dll
Sammansättning:
netstandard.dll

Innehåller metoder som hjälper dig att använda X.509 v.3-certifikat.

public ref class X509Certificate
public ref class X509Certificate : System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable
public ref class X509Certificate : IDisposable, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable
public ref 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
public class X509Certificate : IDisposable
public class X509Certificate : IDisposable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable
[<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
type X509Certificate = class
    interface IDisposable
type X509Certificate = class
    interface IDisposable
    interface IDeserializationCallback
    interface ISerializable
Public Class X509Certificate
Public Class X509Certificate
Implements IDeserializationCallback, ISerializable
Public Class X509Certificate
Implements IDeserializationCallback, IDisposable, ISerializable
Public Class X509Certificate
Implements IDisposable
Arv
Object
X509Certificate
Härledda
Attribut
SerializableAttribute ComVisibleAttribute
Implementeringar
IDeserializationCallback ISerializable IDisposable

Exempel

I följande exempel läses ett X.509-certifikat in från en fil, metoden anropas ToString och resultatet visas för konsolen.

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

Kommentarer

ASN.1 DER är det enda certifikatformat som stöds av den här klassen.

I de flesta scenarier bör du använda X509Certificate2 klassen i stället.

Important

Från och med .NET Framework 4.6 implementerar den här typen gränssnittet IDisposable. När du har använt typen bör du kassera den på ett direkt eller indirekt sätt. Om du vill ta bort typen direkt anropar du dess Dispose metod i ett try/catch block. Om du vill ta bort det indirekt använder du en språkkonstruktion som using (i C#) eller Using (i Visual Basic). Mer information finns i avsnittet "Använda ett objekt som implementerar IDisposable" i IDisposable gränssnittet.

För appar som riktar sig mot .NET Framework 4.5.2 och tidigare versioner implementerar klassen X509Certificate inte gränssnittet IDisposable och har därför ingen Dispose-metod.

Konstruktorer

Name Description
X509Certificate()
Föråldrad.
Föråldrad.

Initierar en ny instans av X509Certificate klassen.
X509Certificate(Byte[], SecureString, X509KeyStorageFlags)

Initierar en ny instans av klassen med hjälp av X509Certificate en bytematris, ett lösenord och en nyckellagringsflagga.
X509Certificate(Byte[], SecureString)

Initierar en ny instans av klassen med hjälp av X509Certificate en bytematris och ett lösenord.
X509Certificate(Byte[], String, X509KeyStorageFlags)

Initierar en ny instans av klassen med hjälp av X509Certificate en bytematris, ett lösenord och en nyckellagringsflagga.
X509Certificate(Byte[], String)

Initierar en ny instans av klassen med hjälp av X509Certificate en bytematris och ett lösenord.
X509Certificate(Byte[])

Initierar en ny instans av X509Certificate klassen som definierats från en sekvens med byte som representerar ett X.509v3-certifikat.
X509Certificate(IntPtr)

Initierar en ny instans av klassen med hjälp av X509Certificate ett handtag till en ohanterad PCCERT_CONTEXT struktur.
X509Certificate(SerializationInfo, StreamingContext)

Initierar en ny instans av klassen med hjälp av X509Certificate ett SerializationInfo objekt och en StreamingContext struktur.
X509Certificate(String, SecureString, X509KeyStorageFlags)

Initierar en ny instans av klassen med hjälp av X509Certificate ett certifikatfilnamn, ett lösenord och en nyckellagringsflagga.
X509Certificate(String, SecureString)

Initierar en ny instans av klassen med hjälp av X509Certificate ett certifikatfilnamn och ett lösenord.
X509Certificate(String, String, X509KeyStorageFlags)

Initierar en ny instans av X509Certificate klassen med namnet på en PKCS7-signerad fil, ett lösenord för att komma åt certifikatet och en nyckellagringsflagga.
X509Certificate(String, String)

Initierar en ny instans av X509Certificate klassen med namnet på en PKCS7-signerad fil och ett lösenord för att få åtkomst till certifikatet.
X509Certificate(String)

Initierar en ny instans av X509Certificate klassen med namnet på en PKCS7-signerad fil.
X509Certificate(X509Certificate)

Initierar en ny instans av klassen med hjälp av X509Certificate en annan X509Certificate klass.

Egenskaper

Name Description
Handle

Hämtar ett handtag till en Microsoft kryptografisk API-certifikatkontext som beskrivs av en ohanterad PCCERT_CONTEXT struktur.
Issuer

Hämtar namnet på certifikatutfärdare som utfärdade X.509v3-certifikatet.
Subject

Hämtar ämnets unika namn från certifikatet.

Metoder

Name Description
CreateFromCertFile(String)

Skapar ett X.509v3-certifikat från den angivna PKCS7-signerade filen.
CreateFromSignedFile(String)

Skapar ett X.509v3-certifikat från den angivna signerade filen.
Dispose()

Frigör alla resurser som används av det aktuella X509Certificate objektet.
Dispose(Boolean)

Släpper alla ohanterade resurser som används av detta X509Certificate och släpper eventuellt de hanterade resurserna.
Equals(Object)

Jämför två X509Certificate objekt för likhet.
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
Equals(X509Certificate)

Jämför två X509Certificate objekt för likhet.
Export(X509ContentType, SecureString)

Exporterar det aktuella X509Certificate objektet till en bytematris med det angivna formatet och ett lösenord.
Export(X509ContentType, String)

Exporterar det aktuella X509Certificate objektet till en bytematris i ett format som beskrivs av ett av X509ContentType värdena och med det angivna lösenordet.
Export(X509ContentType)

Exporterar det aktuella X509Certificate objektet till en bytematris i ett format som beskrivs av något av X509ContentType värdena.
FormatDate(DateTime)

Konverterar angivet datum och tid till en sträng.
GetCertHash()

Returnerar hash-värdet för X.509v3-certifikatet som en matris med byte.
GetCertHash(HashAlgorithmName)

Returnerar hash-värdet för X.509v3-certifikatet som beräknas med hjälp av den angivna kryptografiska hashalgoritmen.
GetCertHashString()

Returnerar SHA-1-hashvärdet för X.509v3-certifikatet som en hexadecimal sträng.
GetCertHashString(HashAlgorithmName)

Returnerar en hexadecimal sträng som innehåller hash-värdet för X.509v3-certifikatet som beräknas med den angivna kryptografiska hashalgoritmen.
GetEffectiveDateString()

Returnerar giltighetsdatumet för det här X.509v3-certifikatet.
GetExpirationDateString()

Returnerar förfallodatumet för det här X.509v3-certifikatet.
GetFormat()

Returnerar namnet på formatet för det här X.509v3-certifikatet.
GetHashCode()

Returnerar hash-koden för X.509v3-certifikatet som ett heltal.
GetIssuerName()
Föråldrad.
Föråldrad.

Returnerar namnet på certifikatutfärdare som utfärdade X.509v3-certifikatet.
GetKeyAlgorithm()

Returnerar nyckelalgoritminformationen för det här X.509v3-certifikatet som en sträng.
GetKeyAlgorithmParameters()

Returnerar nyckelalgoritmparametrarna för X.509v3-certifikatet som en matris med byte.
GetKeyAlgorithmParametersString()

Returnerar nyckelalgoritmparametrarna för X.509v3-certifikatet som en hexadecimal sträng.
GetName()
Föråldrad.
Föråldrad.

Returnerar namnet på det huvudnamn som certifikatet utfärdades till.
GetPublicKey()

Returnerar den offentliga nyckeln för X.509v3-certifikatet som en matris med byte.
GetPublicKeyString()

Returnerar den offentliga nyckeln för X.509v3-certifikatet som en hexadecimal sträng.
GetRawCertData()

Returnerar rådata för hela X.509v3-certifikatet som en matris med byte.
GetRawCertDataString()

Returnerar rådata för hela X.509v3-certifikatet som en hexadecimal sträng.
GetSerialNumber()

Returnerar serienumret för X.509v3-certifikatet som en matris med byte i lite endiansk ordning.
GetSerialNumberString()

Returnerar serienumret för X.509v3-certifikatet som en big-endian hexadecimal sträng.
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
Import(Byte[], SecureString, X509KeyStorageFlags)

Fyller i ett X509Certificate objekt med data från en bytematris, ett lösenord och en nyckellagringsflagga.
Import(Byte[], String, X509KeyStorageFlags)

Fyller i X509Certificate objektet med data från en bytematris, ett lösenord och flaggor för att avgöra hur den privata nyckeln importeras.
Import(Byte[])

Fyller i X509Certificate objektet med data från en bytematris.
Import(String, SecureString, X509KeyStorageFlags)

Fyller i ett X509Certificate objekt med information från en certifikatfil, ett lösenord och en nyckellagringsflagga.
Import(String, String, X509KeyStorageFlags)

Fyller i X509Certificate objektet med information från en certifikatfil, ett lösenord och ett X509KeyStorageFlags värde.
Import(String)

Fyller i X509Certificate objektet med information från en certifikatfil.
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
Reset()

Återställer objektets X509Certificate2 tillstånd.
ToString()

Returnerar en strängrepresentation av det aktuella X509Certificate objektet.
ToString(Boolean)

Returnerar en strängrepresentation av det aktuella X509Certificate objektet, med extra information, om det anges.
TryGetCertHash(HashAlgorithmName, Span<Byte>, Int32)

Försöker skapa ett tumavtryck för certifikatet genom att hasha den kodade representationen av certifikatet med den angivna hash-algoritmen.

Explicita gränssnittsimplementeringar

Name Description
IDeserializationCallback.OnDeserialization(Object)

Implementerar ISerializable gränssnittet och anropas tillbaka av deserialiseringshändelsen när deserialiseringen är klar.
ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Hämtar serialiseringsinformation med alla data som behövs för att återskapa en instans av det aktuella X509Certificate objektet.

Gäller för