X509Certificate Klasa

Definicja

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 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
Dziedziczenie
X509Certificate
Pochodne
Atrybuty
Implementuje

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, należy użyć konstrukcji językowej, 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()
Nieaktualne.

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 klasy przy użyciu tablicy bajtów X509Certificate , 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 klasy przy użyciu tablicy bajtów X509Certificate , 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)

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 klasy przy użyciu nazwy pliku certyfikatu X509Certificate , 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.

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(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
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()
Nieaktualne.
Nieaktualne.
Nieaktualne.
Nieaktualne.

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()
Nieaktualne.
Nieaktualne.
Nieaktualne.
Nieaktualne.

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 nieprzetworzone dane 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[])
Nieaktualne.

X509Certificate Wypełnia obiekt danymi z tablicy bajtów.

Import(Byte[], SecureString, X509KeyStorageFlags)
Nieaktualne.

X509Certificate Wypełnia obiekt przy użyciu danych z tablicy bajtów, hasła i flagi magazynu kluczy.

Import(Byte[], String, X509KeyStorageFlags)
Nieaktualne.

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)
Nieaktualne.

X509Certificate Wypełnia obiekt informacjami z pliku certyfikatu.

Import(String, SecureString, X509KeyStorageFlags)
Nieaktualne.

X509Certificate Wypełnia obiekt informacjami z pliku certyfikatu, hasła i flagi magazynu kluczy.

Import(String, String, X509KeyStorageFlags)
Nieaktualne.

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, tworząc skrót 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 odtworzenia wystąpienia bieżącego X509Certificate obiektu.

Dotyczy