X509Certificate Sınıf

Tanım

Ad Alanı:

System.Security.Cryptography.X509Certificates

Bütünleştirilmiş Kod:

System.Security.Cryptography.X509Certificates.dll

Bütünleştirilmiş Kod:

System.Security.Cryptography.dll

Bütünleştirilmiş Kod:

mscorlib.dll

Bütünleştirilmiş Kod:

netstandard.dll

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

Devralma

Object

X509Certificate

Türetilmiş

System.Security.Cryptography.X509Certificates.X509Certificate2

Öznitelikler

SerializableAttribute ComVisibleAttribute

Uygulamalar

IDisposable IDeserializationCallback ISerializable

Örnekler

Aşağıdaki örnek bir dosyadan X.509 sertifikasını ToString yükler, yöntemini çağırır 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

bu tür, .NET Framework 4.6'dan başlayarak arabirimini IDisposable uygular. 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 blok içinde çağırın.Dispose Bunu dolaylı olarak atmak için (C#'de) 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 bir 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 X509Certificate tanıtıcı kullanarak sınıfının yeni bir örneğini başlatır.
X509Certificate(SerializationInfo, StreamingContext)	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ın yeni bir örneğini X509Certificate 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ın yeni bir örneğini başlatır.
X509Certificate(X509Certificate)	Başka X509Certificate bir sınıf kullanarak sınıfın X509Certificate yeni bir örneğini 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(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
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 tanımlanan biçimde ve belirtilen parolayı kullanarak 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 sona erme 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. Geçersiz. Geçersiz. 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. Geçersiz. Geçersiz. 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ının ham verilerini 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 dize 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 durumunu X509Certificate2 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 oluşturarak sertifika için bir "parmak izi" üretmeye çalışır.

Belirtik Arabirim Kullanımları

IDeserializationCallback.OnDeserialization(Object)	arabirimini ISerializable uygular 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.