X509Certificate Třída

Definice

Obor názvů:

System.Security.Cryptography.X509Certificates

Sestavení:

System.Security.Cryptography.dll

Zdroj:

X509Certificate.cs

Poskytuje metody, které vám pomůžou používat certifikáty X.509 verze 3.

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

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

type X509Certificate = class
    interface IDisposable
    interface IDeserializationCallback
    interface ISerializable

Public Class X509Certificate
Implements IDeserializationCallback, IDisposable, ISerializable

Dědičnost

Object

X509Certificate

Odvozené

System.Security.Cryptography.X509Certificates.X509Certificate2

Implementuje

IDisposable IDeserializationCallback ISerializable

Příklady

Následující příklad načte certifikát X.509 ze souboru, zavolá metodu ToString a zobrazí výsledky do konzoly.

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

Poznámky

ASN.1 DER je jediným formátem certifikátu podporovaným touto třídou.

Ve většině scénářů byste místo toho měli použít X509Certificate2 třídu .

Důležité

Počínaje rozhraním .NET Framework 4.6 tento typ implementuje IDisposable rozhraní . Až s použitím typu skončíte, měli byste ho odstranit přímo nebo nepřímo. Chcete-li odstranit typ přímo, zavolejte jeho Dispose metodu try/catch v bloku. Pokud ho chcete odstranit nepřímo, použijte konstruktor jazyka, jako using je (v jazyce C#) nebo Using (v jazyce Visual Basic). Další informace najdete v části "Použití objektu, který implementuje IDisposable" v IDisposable tématu rozhraní.

Pro aplikace, které cílí na rozhraní .NET Framework 4.5.2 a starší verze, X509Certificate třída neimplementuje IDisposable rozhraní, a proto nemá metodu Dispose .

Konstruktory

X509Certificate()	Zastaralé. Inicializuje novou instanci X509Certificate třídy .
X509Certificate(Byte[])	Inicializuje novou instanci X509Certificate třídy definované ze sekvence bajtů představující certifikát X.509v3.
X509Certificate(Byte[], SecureString)	Inicializuje novou instanci X509Certificate třídy pomocí pole bajtů a hesla.
X509Certificate(Byte[], SecureString, X509KeyStorageFlags)	Inicializuje novou instanci X509Certificate třídy pomocí pole bajtů, hesla a příznaku úložiště klíčů.
X509Certificate(Byte[], String)	Inicializuje novou instanci X509Certificate třídy pomocí pole bajtů a hesla.
X509Certificate(Byte[], String, X509KeyStorageFlags)	Inicializuje novou instanci X509Certificate třídy pomocí pole bajtů, hesla a příznaku úložiště klíčů.
X509Certificate(IntPtr)	Inicializuje novou instanci X509Certificate třídy pomocí popisovače nespravované PCCERT_CONTEXT struktury.
X509Certificate(SerializationInfo, StreamingContext)	Zastaralé. Inicializuje novou instanci X509Certificate třídy pomocí objektu SerializationInfoStreamingContext a struktury.
X509Certificate(String)	Inicializuje novou instanci X509Certificate třídy pomocí názvu podepsaného souboru PKCS7.
X509Certificate(String, SecureString)	Inicializuje novou instanci X509Certificate třídy pomocí názvu souboru certifikátu a hesla.
X509Certificate(String, SecureString, X509KeyStorageFlags)	Inicializuje novou instanci X509Certificate třídy pomocí názvu souboru certifikátu, hesla a příznaku úložiště klíčů.
X509Certificate(String, String)	Inicializuje novou instanci X509Certificate třídy pomocí názvu podepsaného souboru PKCS7 a hesla pro přístup k certifikátu.
X509Certificate(String, String, X509KeyStorageFlags)	Inicializuje novou instanci X509Certificate třídy pomocí názvu podepsaného souboru PKCS7, hesla pro přístup k certifikátu a příznaku úložiště klíčů.
X509Certificate(X509Certificate)	Inicializuje novou instanci X509Certificate třídy pomocí jiné X509Certificate třídy.

Vlastnosti

Handle	Získá popisovač do kontextu certifikátu rozhraní Microsoft Cryptographic API popsaného nespravovanou PCCERT_CONTEXT strukturou.
Issuer	Získá název certifikační autority, která vydala certifikát X.509v3.
SerialNumberBytes	Získá big-endian reprezentaci sériového čísla certifikátu.
Subject	Získá rozlišující název subjektu z certifikátu.

Metody

CreateFromCertFile(String)	Vytvoří certifikát X.509v3 ze zadaného podepsaného souboru PKCS7.
CreateFromSignedFile(String)	Vytvoří certifikát X.509v3 ze zadaného podepsaného souboru.
Dispose()	Uvolní všechny prostředky používané aktuálním X509Certificate objektem.
Dispose(Boolean)	Uvolní všechny nespravované prostředky používané tímto X509Certificate příkazem a volitelně uvolní spravované prostředky.
Equals(Object)	Porovná dva X509Certificate objekty z hlediska rovnosti.
Equals(X509Certificate)	Porovná dva X509Certificate objekty z hlediska rovnosti.
Export(X509ContentType)	Exportuje aktuální X509Certificate objekt do pole bajtů ve formátu popsaném jednou z X509ContentType hodnot.
Export(X509ContentType, SecureString)	Exportuje aktuální X509Certificate objekt do pole bajtů pomocí zadaného formátu a hesla.
Export(X509ContentType, String)	Exportuje aktuální X509Certificate objekt do pole bajtů ve formátu popsaném jednou z X509ContentType hodnot a pomocí zadaného hesla.
FormatDate(DateTime)	Převede zadané datum a čas na řetězec.
GetCertHash()	Vrátí hodnotu hash pro certifikát X.509v3 jako pole bajtů.
GetCertHash(HashAlgorithmName)	Vrátí hodnotu hash certifikátu X.509v3 vypočítanou pomocí zadaného kryptografického hash algoritmu.
GetCertHashString()	Vrátí hodnotu hash SHA1 pro certifikát X.509v3 jako šestnáctkový řetězec.
GetCertHashString(HashAlgorithmName)	Vrátí šestnáctkový řetězec obsahující hodnotu hash certifikátu X.509v3 vypočítanou pomocí zadaného kryptografického hash algoritmu.
GetEffectiveDateString()	Vrátí datum účinnosti tohoto certifikátu X.509v3.
GetExpirationDateString()	Vrátí datum vypršení platnosti tohoto certifikátu X.509v3.
GetFormat()	Vrátí název formátu tohoto certifikátu X.509v3.
GetHashCode()	Vrátí kód hash pro certifikát X.509v3 jako celé číslo.
GetIssuerName()	Zastaralé. Vrátí název certifikační autority, která vydala certifikát X.509v3.
GetKeyAlgorithm()	Vrátí informace o algoritmu klíče pro tento certifikát X.509v3 jako řetězec.
GetKeyAlgorithmParameters()	Vrátí parametry klíčového algoritmu pro certifikát X.509v3 jako pole bajtů.
GetKeyAlgorithmParametersString()	Vrátí parametry klíčového algoritmu pro certifikát X.509v3 jako šestnáctkový řetězec.
GetName()	Zastaralé. Vrátí název objektu zabezpečení, kterému byl certifikát vystaven.
GetPublicKey()	Vrátí veřejný klíč pro certifikát X.509v3 jako pole bajtů.
GetPublicKeyString()	Vrátí veřejný klíč pro certifikát X.509v3 jako šestnáctkový řetězec.
GetRawCertData()	Vrátí nezpracovaná data pro celý certifikát X.509v3 jako pole bajtů.
GetRawCertDataString()	Vrátí nezpracovaná data pro celý certifikát X.509v3 jako šestnáctkový řetězec.
GetSerialNumber()	Vrátí pořadové číslo certifikátu X.509v3 jako pole bajtů v pořadí little-endian.
GetSerialNumberString()	Vrátí pořadové číslo certifikátu X.509v3 jako hexadecimální řetězec little-endian .
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
Import(Byte[])	Zastaralé. Naplní X509Certificate objekt daty z pole bajtů.
Import(Byte[], SecureString, X509KeyStorageFlags)	Zastaralé. Naplní X509Certificate objekt pomocí dat z pole bajtů, hesla a příznaku úložiště klíčů.
Import(Byte[], String, X509KeyStorageFlags)	Zastaralé. Naplní X509Certificate objekt pomocí dat z pole bajtů, hesla a příznaků pro určení způsobu importu privátního klíče.
Import(String)	Zastaralé. Naplní X509Certificate objekt informacemi ze souboru certifikátu.
Import(String, SecureString, X509KeyStorageFlags)	Zastaralé. Naplní X509Certificate objekt informacemi ze souboru certifikátu, heslem a příznakem úložiště klíčů.
Import(String, String, X509KeyStorageFlags)	Zastaralé. Naplní X509Certificate objekt informacemi ze souboru certifikátu, heslem a X509KeyStorageFlags hodnotou.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
Reset()	Obnoví stav objektu X509Certificate2 .
ToString()	Vrátí řetězcovou reprezentaci aktuálního X509Certificate objektu.
ToString(Boolean)	Vrátí řetězcovou reprezentaci aktuálního X509Certificate objektu s dalšími informacemi, pokud jsou zadané.
TryGetCertHash(HashAlgorithmName, Span<Byte>, Int32)	Pokusí se vytvořit "kryptografický otisk" certifikátu pomocí hash zakódované reprezentace certifikátu se zadaným hashovacím algoritmem.

Explicitní implementace rozhraní

IDeserializationCallback.OnDeserialization(Object)	Implementuje ISerializable rozhraní a je volána zpět deserializace událostí při dokončení deserializace.
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Získá serializační informace se všemi daty potřebnými k opětovnému vytvoření instance aktuálního X509Certificate objektu.