X509Certificate Класс

Определение

Пространство имен:

System.Security.Cryptography.X509Certificates

Сборка:

System.Security.Cryptography.dll

Исходный код:

X509Certificate.cs

Предоставляет методы, помогающие использовать сертификаты 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

Наследование

Object

X509Certificate

Производный

System.Security.Cryptography.X509Certificates.X509Certificate2

Реализации

IDisposable IDeserializationCallback ISerializable

Примеры

Следующий пример загружает сертификат X.509 из файла, вызывает ToString метод и отображает результаты в консоли.

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

Комментарии

ASN.1 DER — это единственный формат сертификата, поддерживаемый этим классом.

В большинстве сценариев вместо этого следует использовать X509Certificate2 класс .

Важно!

Начиная с платформа .NET Framework 4.6, этот тип реализует IDisposable интерфейс . По окончании использования выдаленную ему память следует прямо или косвенно освободить. Чтобы сделать это прямо, вызовите его метод Dispose в блоке try/catch. Чтобы сделать это косвенно, используйте языковые конструкции, такие как using (в C#) или Using (в Visual Basic). Дополнительные сведения см. в разделе "Использование объекта, реализующего IDisposable" в статье об интерфейсе IDisposable.

Для приложений, предназначенных для платформа .NET Framework 4.5.2 и более ранних версий, класс не реализует IDisposable интерфейс и, следовательно, X509Certificate не имеет Dispose метода .

Конструкторы

X509Certificate()	Устаревшие.. Инициализирует новый экземпляр класса X509Certificate.
X509Certificate(Byte[])	Инициализирует новый класс X509Certificate, определенный из последовательности байтов, представляющих сертификат X.509v3.
X509Certificate(Byte[], SecureString)	Инициализирует новый экземпляр класса X509Certificate с использованием массива байтов и пароля.
X509Certificate(Byte[], SecureString, X509KeyStorageFlags)	Инициализирует новый экземпляр класса X509Certificate с использованием массива байтов, пароля и флага хранилища ключей.
X509Certificate(Byte[], String)	Инициализирует новый экземпляр класса X509Certificate с использованием массива байтов и пароля.
X509Certificate(Byte[], String, X509KeyStorageFlags)	Инициализирует новый экземпляр класса X509Certificate с использованием массива байтов, пароля и флага хранилища ключей.
X509Certificate(IntPtr)	Инициализирует новый экземпляр класса X509Certificate с помощью дескриптора неуправляемой структуры PCCERT_CONTEXT.
X509Certificate(SerializationInfo, StreamingContext)	Устаревшие.. Инициализирует новый экземпляр класса X509Certificate с помощью объекта SerializationInfo и структуры StreamingContext.
X509Certificate(String)	Инициализирует новый экземпляр класса X509Certificate именем подписанного файла PKCS7.
X509Certificate(String, SecureString)	Инициализирует новый экземпляр класса X509Certificate с использованием имени файла сертификата и пароля.
X509Certificate(String, SecureString, X509KeyStorageFlags)	Инициализирует новый экземпляр класса X509Certificate с использованием имени файла сертификата, пароля и флага хранилища ключа.
X509Certificate(String, String)	Инициализирует новый экземпляр класса X509Certificate, именем подписанного файла PKCS7 и паролем для доступа к сертификату.
X509Certificate(String, String, X509KeyStorageFlags)	Инициализирует новый экземпляр класса X509Certificate, именем подписанного файла PKCS7 и паролем для доступа к сертификату и флагом хранилища ключей.
X509Certificate(X509Certificate)	Инициализирует новый экземпляр класса X509Certificate с помощью другого класса X509Certificate.

Свойства

Handle	Получает дескриптор контекста сертификата Microsoft Cryptographic API, описанный неуправляемой структурой PCCERT_CONTEXT.
Issuer	Получает имя центра сертификации, выдавшего сертификат X.509v3.
SerialNumberBytes	Возвращает представление большого байта серийного номера сертификата.
Subject	Возвращает различающееся имя субъекта из сертификата.

Методы

CreateFromCertFile(String)	Создает сертификат X.509v3 из заданного подписанного файла PKCS7.
CreateFromSignedFile(String)	Создает сертификат X.509v3 из заданного подписанного файла.
Dispose()	Освобождает все ресурсы, используемые текущим объектом X509Certificate.
Dispose(Boolean)	Освобождает все неуправляемые ресурсы, используемые объектом X509Certificate, и при необходимости освобождает также управляемые ресурсы.
Equals(Object)	Сравнивает два объекта X509Certificate на равенство.
Equals(X509Certificate)	Сравнивает два объекта X509Certificate на равенство.
Export(X509ContentType)	Экспортирует текущий объект X509Certificate в массив байтов в формате, описанном одним из значений X509ContentType.
Export(X509ContentType, SecureString)	Экспортирует текущий объект X509Certificate в массив байтов с использованием заданных формата и пароля.
Export(X509ContentType, String)	Экспортирует текущий объект X509Certificate в массив байтов в формате, описанном одним из значений X509ContentType, с использованием заданного пароля.
FormatDate(DateTime)	Преобразует указанные дату и время в строку.
GetCertHash()	Возвращает хэш-значение для сертификата X.509v3 в виде массива байтов.
GetCertHash(HashAlgorithmName)	Возвращает хэш-значение для сертификата X.509v3, который вычисляется с помощью указанного криптографического хэш-алгоритма.
GetCertHashString()	Возвращает хэш-значение SHA1 для сертификата X.509v3 в виде шестнадцатеричной строки.
GetCertHashString(HashAlgorithmName)	Возвращает шестнадцатеричную строку, содержащую хэш-значение для сертификата X.509v3, который вычисляется с помощью указанного криптографического хэш-алгоритма.
GetEffectiveDateString()	Возвращает дату вступления в силу сертификата X.509v3.
GetExpirationDateString()	Возвращает срок действия сертификата X.509v3.
GetFormat()	Возвращает имя формата данного сертификата X.509v3.
GetHashCode()	Возвращает хэш-код для сертификата X.509v3 в виде целого числа.
GetIssuerName()	Устаревшие.. Возвращает имя центра сертификации, выдавшего сертификат X.509v3.
GetKeyAlgorithm()	Возвращает сведения об алгоритме ключа для сертификата X.509v3 в виде строки.
GetKeyAlgorithmParameters()	Возвращает параметры алгоритма ключа для сертификата X.509v3 в виде массива байтов.
GetKeyAlgorithmParametersString()	Возвращает параметры алгоритма ключа для сертификата X.509v3 в виде шестнадцатеричной строки.
GetName()	Устаревшие.. Возвращает имя участника, которому выдан сертификат.
GetPublicKey()	Возвращает открытый ключ для сертификата X.509v3 в виде массива байтов.
GetPublicKeyString()	Возвращает открытый ключ для сертификата X.509v3 в виде шестнадцатеричной строки.
GetRawCertData()	Возвращает необработанные данные для всего сертификата X.509v3 в виде массива байтов.
GetRawCertDataString()	Возвращает необработанные данные для всего сертификата X.509v3 в виде шестнадцатеричной строки.
GetSerialNumber()	Возвращает серийный номер сертификата X.509v3 в виде массива байтов в прямом порядке.
GetSerialNumberString()	Возвращает серийный номер сертификата X.509v3 в виде шестнадцатеричной строки в прямом порядке.
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
Import(Byte[])	Устаревшие.. Заполняет объект X509Certificate данными из массива байтов.
Import(Byte[], SecureString, X509KeyStorageFlags)	Устаревшие.. Заполняет объект X509Certificate с помощью данных из массива данных, пароля и флага хранилища ключа.
Import(Byte[], String, X509KeyStorageFlags)	Устаревшие.. Заполняет объект X509Certificate с помощью данных из массива байтов, пароля и флагов, чтобы определить способ импорта закрытого ключа.
Import(String)	Устаревшие.. Заполняет объект X509Certificate сведениями из файла сертификата.
Import(String, SecureString, X509KeyStorageFlags)	Устаревшие.. Заполняет объект X509Certificate сведениями из файла сертификата, паролем и флагом хранилища ключа.
Import(String, String, X509KeyStorageFlags)	Устаревшие.. Заполняет объект X509Certificate сведениями из файла сертификата, паролем и значением X509KeyStorageFlags.
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
Reset()	Сбрасывает состояние объекта X509Certificate2.
ToString()	Возвращает строковое представление текущего объекта X509Certificate.
ToString(Boolean)	Возвращает строковое представление текущего объекта X509Certificate с дополнительными сведениями, если заданы.
TryGetCertHash(HashAlgorithmName, Span<Byte>, Int32)	Пытается создать "отпечаток" для сертификата путем хэширования закодированного представления сертификата с помощью указанного хэш-алгоритма.

Явные реализации интерфейса

IDeserializationCallback.OnDeserialization(Object)	Реализует интерфейс ISerializable и вызывается событием десериализации после завершения десериализации в ходе обратного вызова.
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Получает сведения сериализации со всеми данными, необходимыми для повторного создания экземпляра текущего объекта X509Certificate.