X509Certificate Klasa

Definicja

Przestrzeń nazw:

System.Security.Cryptography.X509Certificates

Zestaw:

System.Security.Cryptography.dll

Źródło:

X509Certificate.cs

Udostępnia metody, które ułatwiają korzystanie z certyfikatów 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

Dziedziczenie

Object

X509Certificate

Pochodne

System.Security.Cryptography.X509Certificates.X509Certificate2

Implementuje

IDisposable IDeserializationCallback ISerializable

Przykłady

Poniższy przykład ładuje certyfikat X.509 z pliku, wywołuje ToString metodę i wyświetla wyniki w konsoli.

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

Uwagi

ASN.1 DER jest jedynym formatem certyfikatu obsługiwanym przez tę klasę.

W większości scenariuszy należy zamiast tego użyć X509Certificate2 klasy .

Ważne

Począwszy od .NET Framework 4.6, ten typ implementuje IDisposable interfejs. Po zakończeniu korzystania z typu należy usunąć go bezpośrednio lub pośrednio. Aby bezpośrednio usunąć typ, wywołaj jego Dispose metodę try/catch w bloku. Aby usunąć go pośrednio, użyj konstrukcji języka, takiej jak using (w języku C#) lub Using (w Visual Basic). Aby uzyskać więcej informacji, zobacz sekcję "Using an Object that Implements IDisposable" (Używanie obiektu implementujące interfejs IDisposable) w temacie interfejsu IDisposable .

W przypadku aplikacji przeznaczonych dla .NET Framework 4.5.2 i starszych wersji X509Certificate klasa nie implementuje interfejsu IDisposable i dlatego nie ma Dispose metody.

Konstruktory

X509Certificate()	Przestarzałe. Inicjuje nowe wystąpienie klasy X509Certificate.
X509Certificate(Byte[])	Inicjuje nowe wystąpienie X509Certificate klasy zdefiniowanej na podstawie sekwencji bajtów reprezentujących certyfikat X.509v3.
X509Certificate(Byte[], SecureString)	Inicjuje X509Certificate nowe wystąpienie klasy przy użyciu tablicy bajtów i hasła.
X509Certificate(Byte[], SecureString, X509KeyStorageFlags)	Inicjuje nowe wystąpienie X509Certificate klasy przy użyciu tablicy bajtów, hasła i flagi magazynu kluczy.
X509Certificate(Byte[], String)	Inicjuje X509Certificate nowe wystąpienie klasy przy użyciu tablicy bajtów i hasła.
X509Certificate(Byte[], String, X509KeyStorageFlags)	Inicjuje nowe wystąpienie X509Certificate klasy przy użyciu tablicy bajtów, hasła i flagi magazynu kluczy.
X509Certificate(IntPtr)	Inicjuje X509Certificate nowe wystąpienie klasy przy użyciu uchwytu do struktury niezarządzanej PCCERT_CONTEXT .
X509Certificate(SerializationInfo, StreamingContext)	Przestarzałe. Inicjuje X509Certificate nowe wystąpienie klasy przy użyciu SerializationInfo obiektu i StreamingContext struktury.
X509Certificate(String)	Inicjuje X509Certificate nowe wystąpienie klasy przy użyciu nazwy podpisanego pliku PKCS7.
X509Certificate(String, SecureString)	Inicjuje nowe wystąpienie X509Certificate klasy przy użyciu nazwy pliku certyfikatu i hasła.
X509Certificate(String, SecureString, X509KeyStorageFlags)	Inicjuje nowe wystąpienie X509Certificate klasy przy użyciu nazwy pliku certyfikatu, hasła i flagi magazynu kluczy.
X509Certificate(String, String)	Inicjuje nowe wystąpienie X509Certificate klasy przy użyciu nazwy podpisanego pliku PKCS7 i hasła w celu uzyskania dostępu do certyfikatu.
X509Certificate(String, String, X509KeyStorageFlags)	Inicjuje nowe wystąpienie X509Certificate klasy przy użyciu nazwy podpisanego pliku PKCS7, hasła dostępu do certyfikatu i flagi magazynu kluczy.
X509Certificate(X509Certificate)	Inicjuje X509Certificate nowe wystąpienie klasy przy użyciu innej X509Certificate klasy.

Właściwości

Handle	Pobiera dojście do kontekstu certyfikatu interfejsu API kryptograficznego firmy Microsoft opisanego przez niezarządzaną PCCERT_CONTEXT strukturę.
Issuer	Pobiera nazwę urzędu certyfikacji, który wystawił certyfikat X.509v3.
SerialNumberBytes	Pobiera reprezentację big-endian numeru seryjnego certyfikatu.
Subject	Pobiera nazwę wyróżniającą podmiotu z certyfikatu.

Metody

CreateFromCertFile(String)	Tworzy certyfikat X.509v3 z określonego podpisanego pliku PKCS7.
CreateFromSignedFile(String)	Tworzy certyfikat X.509v3 z określonego podpisanego pliku.
Dispose()	Zwalnia wszystkie zasoby używane przez bieżący X509Certificate obiekt.
Dispose(Boolean)	Zwalnia wszystkie niezarządzane zasoby używane przez tę X509Certificate i opcjonalnie zwalnia zarządzane zasoby.
Equals(Object)	Porównuje dwa X509Certificate obiekty pod kątem równości.
Equals(X509Certificate)	Porównuje dwa X509Certificate obiekty pod kątem równości.
Export(X509ContentType)	Eksportuje bieżący X509Certificate obiekt do tablicy bajtów w formacie opisanym przez jedną z X509ContentType wartości.
Export(X509ContentType, SecureString)	Eksportuje bieżący X509Certificate obiekt do tablicy bajtów przy użyciu określonego formatu i hasła.
Export(X509ContentType, String)	Eksportuje bieżący X509Certificate obiekt do tablicy bajtów w formacie opisanym przez jedną z X509ContentType wartości i przy użyciu określonego hasła.
FormatDate(DateTime)	Konwertuje określoną datę i godzinę na ciąg.
GetCertHash()	Zwraca wartość skrótu dla certyfikatu X.509v3 jako tablicę bajtów.
GetCertHash(HashAlgorithmName)	Zwraca wartość skrótu dla certyfikatu X.509v3 obliczonego przy użyciu określonego algorytmu skrótu kryptograficznego.
GetCertHashString()	Zwraca wartość skrótu SHA1 dla certyfikatu X.509v3 jako ciąg szesnastkowy.
GetCertHashString(HashAlgorithmName)	Zwraca ciąg szesnastkowy zawierający wartość skrótu dla certyfikatu X.509v3 obliczonego przy użyciu określonego algorytmu skrótu kryptograficznego.
GetEffectiveDateString()	Zwraca datę wejścia w życie tego certyfikatu X.509v3.
GetExpirationDateString()	Zwraca datę wygaśnięcia tego certyfikatu X.509v3.
GetFormat()	Zwraca nazwę formatu tego certyfikatu X.509v3.
GetHashCode()	Zwraca kod skrótu dla certyfikatu X.509v3 jako liczbę całkowitą.
GetIssuerName()	Przestarzałe. Zwraca nazwę urzędu certyfikacji, który wystawił certyfikat X.509v3.
GetKeyAlgorithm()	Zwraca informacje o algorytmie klucza dla tego certyfikatu X.509v3 jako ciąg.
GetKeyAlgorithmParameters()	Zwraca parametry algorytmu klucza dla certyfikatu X.509v3 jako tablicę bajtów.
GetKeyAlgorithmParametersString()	Zwraca parametry algorytmu klucza dla certyfikatu X.509v3 jako ciąg szesnastkowy.
GetName()	Przestarzałe. Zwraca nazwę podmiotu zabezpieczeń, do którego wystawiono certyfikat.
GetPublicKey()	Zwraca klucz publiczny certyfikatu X.509v3 jako tablicę bajtów.
GetPublicKeyString()	Zwraca klucz publiczny certyfikatu X.509v3 jako ciąg szesnastkowy.
GetRawCertData()	Zwraca dane pierwotne dla całego certyfikatu X.509v3 jako tablicę bajtów.
GetRawCertDataString()	Zwraca dane pierwotne dla całego certyfikatu X.509v3 jako ciąg szesnastkowy.
GetSerialNumber()	Zwraca numer seryjny certyfikatu X.509v3 jako tablicę bajtów w kolejności mało endińskiej.
GetSerialNumberString()	Zwraca numer seryjny certyfikatu X.509v3 jako ciąg szesnastkowy little-endian .
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
Import(Byte[])	Przestarzałe. X509Certificate Wypełnia obiekt danymi z tablicy bajtów.
Import(Byte[], SecureString, X509KeyStorageFlags)	Przestarzałe. X509Certificate Wypełnia obiekt przy użyciu danych z tablicy bajtów, hasła i flagi magazynu kluczy.
Import(Byte[], String, X509KeyStorageFlags)	Przestarzałe. X509Certificate Wypełnia obiekt przy użyciu danych z tablicy bajtów, hasła i flag w celu określenia sposobu importowania klucza prywatnego.
Import(String)	Przestarzałe. X509Certificate Wypełnia obiekt informacjami z pliku certyfikatu.
Import(String, SecureString, X509KeyStorageFlags)	Przestarzałe. X509Certificate Wypełnia obiekt informacjami z pliku certyfikatu, hasła i flagi magazynu kluczy.
Import(String, String, X509KeyStorageFlags)	Przestarzałe. X509Certificate Wypełnia obiekt informacjami z pliku certyfikatu, hasła i X509KeyStorageFlags wartości.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
Reset()	Resetuje stan X509Certificate2 obiektu.
ToString()	Zwraca reprezentację ciągu bieżącego X509Certificate obiektu.
ToString(Boolean)	Zwraca reprezentację ciągu bieżącego X509Certificate obiektu z dodatkowymi informacjami, jeśli określono.
TryGetCertHash(HashAlgorithmName, Span<Byte>, Int32)	Próbuje utworzyć "odcisk palca" dla certyfikatu przez utworzenie skrótu zakodowanej reprezentacji certyfikatu przy użyciu określonego algorytmu skrótu.

Jawne implementacje interfejsu

IDeserializationCallback.OnDeserialization(Object)	Implementuje interfejs i jest wywoływany ISerializable z powrotem przez zdarzenie deserializacji po zakończeniu deserializacji.
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Pobiera informacje o serializacji ze wszystkimi danymi potrzebnymi do ponownego utworzenia wystąpienia bieżącego X509Certificate obiektu.