X509Certificate Sınıf

Tanım

Ad Alanı:

System.Security.Cryptography.X509Certificates

Bütünleştirilmiş Kod:

System.Security.Cryptography.dll

Kaynak:

X509Certificate.cs

X.509 v.3 sertifikalarını kullanmanıza yardımcı olan yöntemler sağlar.

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

Devralma

Object

X509Certificate

Türetilmiş

System.Security.Cryptography.X509Certificates.X509Certificate2

Uygulamalar

IDisposable IDeserializationCallback ISerializable

Örnekler

Aşağıdaki örnek bir dosyadan X.509 sertifikası yükler, yöntemini çağırır ToString ve sonuçları konsolda görüntüler.

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

Açıklamalar

ASN.1 DER, bu sınıf tarafından desteklenen tek sertifika biçimidir.

Çoğu senaryoda bunun yerine sınıfını X509Certificate2 kullanmanız gerekir.

Önemli

.NET Framework 4.6'dan başlayarak, bu tür arabirimi uygularIDisposable. Türünü kullanmayı bitirdiğinizde, doğrudan veya dolaylı olarak atmalısınız. Türü doğrudan atmak için yöntemini bir try/catch blokta çağırın.Dispose Bunu dolaylı olarak atmak için (C#'ta) veya Using (Visual Basic'te) gibi using bir dil yapısı kullanın. Daha fazla bilgi için arabirim konusunun "IDisposable Uygulayan Bir Nesne Kullanma" bölümüne IDisposable bakın.

.NET Framework 4.5.2 ve önceki sürümleri hedefleyen uygulamalar için sınıfı X509Certificate arabirimini uygulamaz IDisposable ve bu nedenle bir Dispose yöntemi yoktur.

Oluşturucular

X509Certificate()	Geçersiz. X509Certificate sınıfının yeni bir örneğini başlatır.
X509Certificate(Byte[])	X.509v3 sertifikasını X509Certificate temsil eden bayt dizisinden tanımlanan sınıfın yeni bir örneğini başlatır.
X509Certificate(Byte[], SecureString)	Bayt dizisi ve parola kullanarak sınıfının yeni bir örneğini X509Certificate başlatır.
X509Certificate(Byte[], SecureString, X509KeyStorageFlags)	Bayt dizisi, parola ve anahtar depolama bayrağı kullanarak sınıfının yeni bir örneğini X509Certificate başlatır.
X509Certificate(Byte[], String)	Bayt dizisi ve parola kullanarak sınıfının yeni bir örneğini X509Certificate başlatır.
X509Certificate(Byte[], String, X509KeyStorageFlags)	Bayt dizisi, parola ve anahtar depolama bayrağı kullanarak sınıfının yeni bir örneğini X509Certificate başlatır.
X509Certificate(IntPtr)	Yönetilmeyen PCCERT_CONTEXT bir yapıya tanıtıcı kullanarak sınıfın X509Certificate yeni bir örneğini başlatır.
X509Certificate(SerializationInfo, StreamingContext)	Geçersiz. Bir nesne ve yapı kullanarak sınıfının yeni bir SerializationInfoStreamingContext örneğini X509Certificate başlatır.
X509Certificate(String)	PKCS7 imzalı dosyasının X509Certificate adını kullanarak sınıfının yeni bir örneğini başlatır.
X509Certificate(String, SecureString)	Sertifika dosya adı ve parola kullanarak sınıfının yeni bir örneğini X509Certificate başlatır.
X509Certificate(String, SecureString, X509KeyStorageFlags)	Sertifika dosya adı, parola ve anahtar depolama bayrağı kullanarak sınıfın X509Certificate yeni bir örneğini başlatır.
X509Certificate(String, String)	Sertifikaya X509Certificate erişmek için PKCS7 imzalı dosyanın adını ve parolayı kullanarak sınıfının yeni bir örneğini başlatır.
X509Certificate(String, String, X509KeyStorageFlags)	PKCS7 imzalı dosyasının X509Certificate adını, sertifikaya erişmek için parolayı ve anahtar depolama bayrağını kullanarak sınıfın yeni bir örneğini başlatır.
X509Certificate(X509Certificate)	Sınıfın X509Certificate yeni bir örneğini başka bir X509Certificate sınıf kullanarak başlatır.

Özellikler

Handle	Yönetilmeyen PCCERT_CONTEXT bir yapı tarafından açıklanan Microsoft Şifreleme API'si sertifika bağlamının tanıtıcısını alır.
Issuer	X.509v3 sertifikasını veren sertifika yetkilisinin adını alır.
SerialNumberBytes	Sertifikanın seri numarasının büyük endian gösterimini alır.
Subject	Sertifikadan konu ayırt edici adını alır.

Yöntemler

CreateFromCertFile(String)	Belirtilen PKCS7 imzalı dosyasından bir X.509v3 sertifikası oluşturur.
CreateFromSignedFile(String)	Belirtilen imzalı dosyadan bir X.509v3 sertifikası oluşturur.
Dispose()	Geçerli X509Certificate nesne tarafından kullanılan tüm kaynakları serbest bırakır.
Dispose(Boolean)	Bunun X509Certificate tarafından kullanılan tüm yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları serbest bırakır.
Equals(Object)	Eşitlik için iki X509Certificate nesneyi karşılaştırır.
Equals(X509Certificate)	Eşitlik için iki X509Certificate nesneyi karşılaştırır.
Export(X509ContentType)	Geçerli X509Certificate nesneyi değerlerden biri tarafından açıklanan biçimde bir bayt dizisine X509ContentType aktarır.
Export(X509ContentType, SecureString)	Belirtilen biçimi ve parolayı kullanarak geçerli X509Certificate nesneyi bir bayt dizisine aktarır.
Export(X509ContentType, String)	Geçerli X509Certificate nesneyi değerlerden biri X509ContentType tarafından açıklanan biçimde ve belirtilen parolayı kullanarak bir bayt dizisine aktarır.
FormatDate(DateTime)	Belirtilen tarih ve saati dizeye dönüştürür.
GetCertHash()	X.509v3 sertifikasının karma değerini bayt dizisi olarak döndürür.
GetCertHash(HashAlgorithmName)	Belirtilen şifreleme karma algoritması kullanılarak hesaplanan X.509v3 sertifikasının karma değerini döndürür.
GetCertHashString()	X.509v3 sertifikasının SHA1 karma değerini onaltılık dize olarak döndürür.
GetCertHashString(HashAlgorithmName)	Belirtilen şifreleme karma algoritması kullanılarak hesaplanan X.509v3 sertifikasının karma değerini içeren onaltılık bir dize döndürür.
GetEffectiveDateString()	Bu X.509v3 sertifikasının geçerlilik tarihini döndürür.
GetExpirationDateString()	Bu X.509v3 sertifikasının son kullanma tarihini döndürür.
GetFormat()	Bu X.509v3 sertifikasının biçiminin adını döndürür.
GetHashCode()	X.509v3 sertifikasının karma kodunu tamsayı olarak döndürür.
GetIssuerName()	Geçersiz. X.509v3 sertifikasını veren sertifika yetkilisinin adını döndürür.
GetKeyAlgorithm()	Bu X.509v3 sertifikasının anahtar algoritması bilgilerini dize olarak döndürür.
GetKeyAlgorithmParameters()	X.509v3 sertifikasının anahtar algoritması parametrelerini bayt dizisi olarak döndürür.
GetKeyAlgorithmParametersString()	X.509v3 sertifikasının anahtar algoritması parametrelerini onaltılık dize olarak döndürür.
GetName()	Geçersiz. Sertifikanın verildiği sorumlunun adını döndürür.
GetPublicKey()	X.509v3 sertifikasının ortak anahtarını bayt dizisi olarak döndürür.
GetPublicKeyString()	X.509v3 sertifikasının ortak anahtarını onaltılık dize olarak döndürür.
GetRawCertData()	X.509v3 sertifikasının tamamı için ham verileri bayt dizisi olarak döndürür.
GetRawCertDataString()	X.509v3 sertifikasının tamamı için ham verileri onaltılık dize olarak döndürür.
GetSerialNumber()	X.509v3 sertifikasının seri numarasını küçük endian sırada bayt dizisi olarak döndürür.
GetSerialNumberString()	X.509v3 sertifikasının seri numarasını küçük endian onaltılık dizesi olarak döndürür.
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
Import(Byte[])	Geçersiz. X509Certificate Nesneyi bayt dizisinden alınan verilerle doldurur.
Import(Byte[], SecureString, X509KeyStorageFlags)	Geçersiz. Bir X509Certificate bayt dizisinden, paroladan ve anahtar depolama bayrağından verileri kullanarak bir nesneyi doldurur.
Import(Byte[], String, X509KeyStorageFlags)	Geçersiz. X509Certificate Bir bayt dizisinden, paroladan ve özel anahtarın nasıl içeri aktarılacağını belirlemek için bayraklardan verileri kullanarak nesneyi doldurur.
Import(String)	Geçersiz. Nesneyi bir sertifika dosyasındaki X509Certificate bilgilerle doldurur.
Import(String, SecureString, X509KeyStorageFlags)	Geçersiz. Bir X509Certificate nesneyi sertifika dosyasından, paroladan ve anahtar depolama bayrağından alınan bilgilerle doldurur.
Import(String, String, X509KeyStorageFlags)	Geçersiz. Nesneyi bir sertifika dosyasından X509Certificate , paroladan ve X509KeyStorageFlags değerden bilgilerle doldurur.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
Reset()	Nesnenin X509Certificate2 durumunu sıfırlar.
ToString()	Geçerli X509Certificate nesnenin dize gösterimini döndürür.
ToString(Boolean)	Belirtildiyse, ek bilgilerle birlikte geçerli X509Certificate nesnenin dize gösterimini döndürür.
TryGetCertHash(HashAlgorithmName, Span<Byte>, Int32)	Sertifikanın kodlanmış gösterimini belirtilen karma algoritmayla karma olarak oluşturarak sertifika için bir "parmak izi" üretmeye çalışır.

Belirtik Arabirim Kullanımları

IDeserializationCallback.OnDeserialization(Object)	Arabirimi uygular ISerializable ve seri durumdan çıkarma işlemi tamamlandığında seri durumdan çıkarma olayı tarafından geri çağrılır.
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Geçerli X509Certificate nesnenin bir örneğini yeniden oluşturmak için gereken tüm verilerle serileştirme bilgilerini alır.