X509Certificate Třída

Definice

Obor názvů:

System.Security.Cryptography.X509Certificates

Sestavení:

System.Security.Cryptography.X509Certificates.dll

Sestavení:

System.Security.Cryptography.dll

Sestavení:

mscorlib.dll

Sestavení:

netstandard.dll

Poskytuje metody, které vám pomůžou používat certifikáty 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

[<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

Dědičnost

Object

X509Certificate

Odvozené

System.Security.Cryptography.X509Certificates.X509Certificate2

Atributy

SerializableAttribute ComVisibleAttribute

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 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ý formát certifikátu podporovaný touto třídou.

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

Důležité

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

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

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í bajtového pole, 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í bajtového pole, hesla a příznaku úložiště klíčů.
X509Certificate(IntPtr)	Inicializuje novou instanci X509Certificate třídy pomocí úchytu pro nespravovanou PCCERT_CONTEXT strukturu.
X509Certificate(SerializationInfo, StreamingContext)	Inicializuje novou instanci X509Certificate třídy pomocí SerializationInfo objektu a StreamingContext 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č k 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.
Subject	Získá rozlišující název subjektu od 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 a volitelně uvolní spravované prostředky.
Equals(Object)	Porovná dva X509Certificate objekty pro rovnost.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
Equals(X509Certificate)	Porovná dva X509Certificate objekty pro rovnost.
Export(X509ContentType)	Exportuje aktuální X509Certificate objekt do bajtového pole 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 bajtového pole 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 pro certifikát X.509v3 vypočítaný 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 pro certifikát X.509v3 vypočítaný pomocí zadaného kryptografického hash algoritmu.
GetEffectiveDateString()	Vrátí platné datum 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é. Zastaralé. Zastaralé. Zastaralé. Vrátí název certifikační autority, která vydala certifikát X.509v3.
GetKeyAlgorithm()	Vrátí informace o klíčovém algoritmu 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é. Zastaralé. Zastaralé. Zastaralé. Vrátí název objektu zabezpečení, ke 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 malém endian pořadí.
GetSerialNumberString()	Vrátí sériové číslo certifikátu X.509v3 jako malý šestnáctkový řetězec .
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
Import(Byte[])	Zastaralé. Naplní X509Certificate objekt daty z bajtového pole.
Import(Byte[], SecureString, X509KeyStorageFlags)	Zastaralé. Naplní X509Certificate objekt pomocí dat z bajtového pole, hesla a příznaku úložiště klíčů.
Import(Byte[], String, X509KeyStorageFlags)	Zastaralé. Naplní X509Certificate objekt pomocí dat z bajtového pole, 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, hesla a příznaku úložiště klíčů.
Import(String, String, X509KeyStorageFlags)	Zastaralé. Naplní X509Certificate objekt informacemi ze souboru certifikátu, hesla a X509KeyStorageFlags hodnoty.
MemberwiseClone()	Vytvoří použádnou kopii aktuálního souboru Object. (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 dodatečnými informacemi, pokud je zadán.
TryGetCertHash(HashAlgorithmName, Span<Byte>, Int32)	Pokusí se pro certifikát vytvořit kryptografický otisk pomocí hodnoty hash zakódované reprezentace certifikátu pomocí zadaného algoritmu hash.

Explicitní implementace rozhraní

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