X509Certificate Kelas

Definisi

Ruang nama:

System.Security.Cryptography.X509Certificates

Rakitan:

System.Security.Cryptography.dll

Sumber:

X509Certificate.cs

Menyediakan metode yang membantu Anda menggunakan sertifikat X.509 v.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

Warisan

Object

X509Certificate

Turunan

System.Security.Cryptography.X509Certificates.X509Certificate2

Penerapan

IDisposable IDeserializationCallback ISerializable

Contoh

Contoh berikut memuat sertifikat X.509 dari file, memanggil ToString metode , dan menampilkan hasilnya ke konsol.

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

Keterangan

ASN.1 DER adalah satu-satunya format sertifikat yang didukung oleh kelas ini.

Untuk sebagian besar skenario, Anda harus menggunakan kelas sebagai gantinya X509Certificate2 .

Penting

Dimulai dengan .NET Framework 4.6, jenis ini mengimplementasikan IDisposable antarmuka. Ketika Anda telah selesai menggunakan jenis , Anda harus membuangnya baik secara langsung atau tidak langsung. Untuk membuang jenis secara langsung, panggil metodenya Dispose dalam try/catch blok. Untuk membuangnya secara tidak langsung, gunakan konstruksi bahasa seperti using (di C#) atau Using (di Visual Basic). Untuk informasi selengkapnya, lihat bagian "Menggunakan Objek yang Mengimplementasikan IDisposable" di IDisposable topik antarmuka.

Untuk aplikasi yang menargetkan .NET Framework 4.5.2 dan versi yang lebih lama, X509Certificate kelas tidak mengimplementasikan IDisposable antarmuka dan karenanya tidak memiliki Dispose metode .

Konstruktor

X509Certificate()	Kedaluwarsa. Menginisialisasi instans baru kelas X509Certificate.
X509Certificate(Byte[])	Menginisialisasi instans X509Certificate baru kelas yang ditentukan dari urutan byte yang mewakili sertifikat X.509v3.
X509Certificate(Byte[], SecureString)	Menginisialisasi instans X509Certificate baru kelas menggunakan array byte dan kata sandi.
X509Certificate(Byte[], SecureString, X509KeyStorageFlags)	Menginisialisasi instans X509Certificate baru kelas menggunakan array byte, kata sandi, dan bendera penyimpanan kunci.
X509Certificate(Byte[], String)	Menginisialisasi instans X509Certificate baru kelas menggunakan array byte dan kata sandi.
X509Certificate(Byte[], String, X509KeyStorageFlags)	Menginisialisasi instans X509Certificate baru kelas menggunakan array byte, kata sandi, dan bendera penyimpanan kunci.
X509Certificate(IntPtr)	Menginisialisasi instans X509Certificate baru kelas menggunakan handel ke struktur yang tidak dikelola PCCERT_CONTEXT .
X509Certificate(SerializationInfo, StreamingContext)	Kedaluwarsa. Menginisialisasi instans X509Certificate baru kelas menggunakan SerializationInfo objek dan StreamingContext struktur.
X509Certificate(String)	Menginisialisasi instans X509Certificate baru kelas menggunakan nama file yang ditandatangani PKCS7.
X509Certificate(String, SecureString)	Menginisialisasi instans X509Certificate baru kelas menggunakan nama file sertifikat dan kata sandi.
X509Certificate(String, SecureString, X509KeyStorageFlags)	Menginisialisasi instans X509Certificate baru kelas menggunakan nama file sertifikat, kata sandi, dan bendera penyimpanan kunci.
X509Certificate(String, String)	Menginisialisasi instans X509Certificate baru kelas menggunakan nama file yang ditandatangani PKCS7 dan kata sandi untuk mengakses sertifikat.
X509Certificate(String, String, X509KeyStorageFlags)	Menginisialisasi instans X509Certificate baru kelas menggunakan nama file yang ditandatangani PKCS7, kata sandi untuk mengakses sertifikat, dan bendera penyimpanan kunci.
X509Certificate(X509Certificate)	Menginisialisasi instans X509Certificate baru kelas menggunakan kelas lain X509Certificate .

Properti

Handle	Mendapatkan handel ke konteks sertifikat MICROSOFT Cryptographic API yang dijelaskan oleh struktur yang tidak dikelola PCCERT_CONTEXT .
Issuer	Mendapatkan nama otoritas sertifikat yang menerbitkan sertifikat X.509v3.
SerialNumberBytes	Mendapatkan representasi big-endian dari nomor seri sertifikat.
Subject	Mendapatkan nama yang dibedakan subjek dari sertifikat.

Metode

CreateFromCertFile(String)	Membuat sertifikat X.509v3 dari file bertanda tangan PKCS7 yang ditentukan.
CreateFromSignedFile(String)	Membuat sertifikat X.509v3 dari file yang ditandatangani yang ditentukan.
Dispose()	Melepaskan semua sumber daya yang digunakan oleh objek saat ini X509Certificate .
Dispose(Boolean)	Merilis semua sumber daya tidak terkelola yang digunakan oleh ini X509Certificate dan secara opsional merilis sumber daya terkelola.
Equals(Object)	Membandingkan dua X509Certificate objek untuk kesetaraan.
Equals(X509Certificate)	Membandingkan dua X509Certificate objek untuk kesetaraan.
Export(X509ContentType)	Mengekspor objek saat ini X509Certificate ke array byte dalam format yang dijelaskan oleh salah X509ContentType satu nilai.
Export(X509ContentType, SecureString)	Mengekspor objek saat ini X509Certificate ke array byte menggunakan format dan kata sandi yang ditentukan.
Export(X509ContentType, String)	Mengekspor objek saat ini X509Certificate ke array byte dalam format yang dijelaskan oleh salah X509ContentType satu nilai, dan menggunakan kata sandi yang ditentukan.
FormatDate(DateTime)	Mengonversi tanggal dan waktu yang ditentukan menjadi string.
GetCertHash()	Mengembalikan nilai hash untuk sertifikat X.509v3 sebagai array byte.
GetCertHash(HashAlgorithmName)	Mengembalikan nilai hash untuk sertifikat X.509v3 yang dihitung dengan menggunakan algoritma hash kriptografi yang ditentukan.
GetCertHashString()	Mengembalikan nilai hash SHA1 untuk sertifikat X.509v3 sebagai string heksadesimal.
GetCertHashString(HashAlgorithmName)	Mengembalikan string heksadesimal yang berisi nilai hash untuk sertifikat X.509v3 yang dihitung menggunakan algoritma hash kriptografi yang ditentukan.
GetEffectiveDateString()	Mengembalikan tanggal efektif sertifikat X.509v3 ini.
GetExpirationDateString()	Mengembalikan tanggal kedaluwarsa sertifikat X.509v3 ini.
GetFormat()	Menampilkan nama format sertifikat X.509v3 ini.
GetHashCode()	Mengembalikan kode hash untuk sertifikat X.509v3 sebagai bilangan bulat.
GetIssuerName()	Kedaluwarsa. Mengembalikan nama otoritas sertifikasi yang menerbitkan sertifikat X.509v3.
GetKeyAlgorithm()	Mengembalikan informasi algoritme kunci untuk sertifikat X.509v3 ini sebagai string.
GetKeyAlgorithmParameters()	Mengembalikan parameter algoritma kunci untuk sertifikat X.509v3 sebagai array byte.
GetKeyAlgorithmParametersString()	Mengembalikan parameter algoritme kunci untuk sertifikat X.509v3 sebagai string heksadesimal.
GetName()	Kedaluwarsa. Mengembalikan nama utama yang sertifikatnya dikeluarkan.
GetPublicKey()	Mengembalikan kunci umum untuk sertifikat X.509v3 sebagai array byte.
GetPublicKeyString()	Mengembalikan kunci publik untuk sertifikat X.509v3 sebagai string heksadesimal.
GetRawCertData()	Mengembalikan data mentah untuk seluruh sertifikat X.509v3 sebagai array byte.
GetRawCertDataString()	Mengembalikan data mentah untuk seluruh sertifikat X.509v3 sebagai string heksadesimal.
GetSerialNumber()	Mengembalikan nomor seri sertifikat X.509v3 sebagai array byte dalam urutan little-endian.
GetSerialNumberString()	Mengembalikan nomor seri sertifikat X.509v3 sebagai string heksadesimal little-endian .
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
Import(Byte[])	Kedaluwarsa. Mengisi X509Certificate objek dengan data dari array byte.
Import(Byte[], SecureString, X509KeyStorageFlags)	Kedaluwarsa. Mengisi X509Certificate objek menggunakan data dari array byte, kata sandi, dan bendera penyimpanan kunci.
Import(Byte[], String, X509KeyStorageFlags)	Kedaluwarsa. Mengisi X509Certificate objek menggunakan data dari array byte, kata sandi, dan bendera untuk menentukan bagaimana kunci privat diimpor.
Import(String)	Kedaluwarsa. Mengisi X509Certificate objek dengan informasi dari file sertifikat.
Import(String, SecureString, X509KeyStorageFlags)	Kedaluwarsa. Mengisi X509Certificate objek dengan informasi dari file sertifikat, kata sandi, dan bendera penyimpanan kunci.
Import(String, String, X509KeyStorageFlags)	Kedaluwarsa. Mengisi X509Certificate objek dengan informasi dari file sertifikat, kata sandi, dan X509KeyStorageFlags nilai.
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
Reset()	Mereset status X509Certificate2 objek.
ToString()	Mengembalikan representasi string dari objek saat ini X509Certificate .
ToString(Boolean)	Mengembalikan representasi string objek saat ini X509Certificate , dengan informasi tambahan, jika ditentukan.
TryGetCertHash(HashAlgorithmName, Span<Byte>, Int32)	Upaya untuk menghasilkan "thumbprint" untuk sertifikat dengan hash representasi sertifikat yang dikodekan dengan algoritma hash yang ditentukan.

Implementasi Antarmuka Eksplisit

IDeserializationCallback.OnDeserialization(Object)	ISerializable Mengimplementasikan antarmuka dan dipanggil kembali oleh peristiwa deserialisasi ketika deserialisasi selesai.
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Mendapatkan informasi serialisasi dengan semua data yang diperlukan untuk membuat ulang instans objek saat ini X509Certificate .