X509Certificate Класс

Определение

Пространство имен:
System.Security.Cryptography.X509Certificates
Сборка:
mscorlib.dll
Сборка:
System.Security.Cryptography.X509Certificates.dll
Сборка:
netstandard.dll

Предоставляет методы, помогающие использовать сертификаты X.509 версии 3.

public ref class X509Certificate
public ref class X509Certificate : System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable
public ref class X509Certificate : IDisposable, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable
public ref 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
public class X509Certificate : IDisposable
public class X509Certificate : IDisposable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable
[<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
type X509Certificate = class
    interface IDisposable
type X509Certificate = class
    interface IDisposable
    interface IDeserializationCallback
    interface ISerializable
Public Class X509Certificate
Public Class X509Certificate
Implements IDeserializationCallback, ISerializable
Public Class X509Certificate
Implements IDeserializationCallback, IDisposable, ISerializable
Public Class X509Certificate
Implements IDisposable
Наследование
Object
X509Certificate
Производный
Атрибуты
SerializableAttribute ComVisibleAttribute
Реализации
IDeserializationCallback ISerializable IDisposable

Примеры

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

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 класс.

Important

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

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

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

Имя Описание
X509Certificate()
Устаревшие..
Устаревшие..

Инициализирует новый экземпляр класса X509Certificate.
X509Certificate(Byte[], SecureString, X509KeyStorageFlags)

Инициализирует новый экземпляр X509Certificate класса с помощью массива байтов, пароля и флага хранилища ключей.
X509Certificate(Byte[], SecureString)

Инициализирует новый экземпляр X509Certificate класса с помощью массива байтов и пароля.
X509Certificate(Byte[], String, X509KeyStorageFlags)

Инициализирует новый экземпляр X509Certificate класса с помощью массива байтов, пароля и флага хранилища ключей.
X509Certificate(Byte[], String)

Инициализирует новый экземпляр X509Certificate класса с помощью массива байтов и пароля.
X509Certificate(Byte[])

Инициализирует новый экземпляр X509Certificate класса, определенный из последовательности байтов, представляющих сертификат X.509v3.
X509Certificate(IntPtr)

Инициализирует новый экземпляр X509Certificate класса с помощью дескриптора в неуправляемую PCCERT_CONTEXT структуру.
X509Certificate(SerializationInfo, StreamingContext)

Инициализирует новый экземпляр X509Certificate класса с помощью SerializationInfo объекта и StreamingContext структуры.
X509Certificate(String, SecureString, X509KeyStorageFlags)

Инициализирует новый экземпляр X509Certificate класса с помощью имени файла сертификата, пароля и флага хранилища ключей.
X509Certificate(String, SecureString)

Инициализирует новый экземпляр X509Certificate класса с помощью имени файла сертификата и пароля.
X509Certificate(String, String, X509KeyStorageFlags)

Инициализирует новый экземпляр X509Certificate класса, используя имя подписанного файла PKCS7, пароль для доступа к сертификату и флаг хранилища ключей.
X509Certificate(String, String)

Инициализирует новый экземпляр класса, используя имя подписанного X509Certificate файла PKCS7 и пароль для доступа к сертификату.
X509Certificate(String)

Инициализирует новый экземпляр X509Certificate класса с помощью имени подписанного PKCS7-файла.
X509Certificate(X509Certificate)

Инициализирует новый экземпляр класса с помощью другого X509CertificateX509Certificate класса.

Свойства

Имя Описание
Handle

Получает дескриптор контекста сертификата API microsoft Cryptographic API, описанного неуправляемой PCCERT_CONTEXT структурой.
Issuer

Возвращает имя центра сертификации, выдавшего сертификат X.509v3.
Subject

Получает различающееся имя субъекта от сертификата.

Методы

Имя Описание
CreateFromCertFile(String)

Создает сертификат X.509v3 из указанного подписанного файла PKCS7.
CreateFromSignedFile(String)

Создает сертификат X.509v3 из указанного подписанного файла.
Dispose()

Освобождает все ресурсы, используемые текущим X509Certificate объектом.
Dispose(Boolean)

Освобождает все неуправляемые ресурсы, используемые этим X509Certificate , и при необходимости освобождает управляемые ресурсы.
Equals(Object)

Сравнивает два объекта X509Certificate на равенство.
Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
Equals(X509Certificate)

Сравнивает два объекта X509Certificate на равенство.
Export(X509ContentType, SecureString)

Экспортирует текущий X509Certificate объект в массив байтов, используя указанный формат и пароль.
Export(X509ContentType, String)

Экспортирует текущий X509Certificate объект в массив байтов в формате, описанном одним из X509ContentType значений, и использует указанный пароль.
Export(X509ContentType)

Экспортирует текущий X509Certificate объект в массив байтов в формате, описанном одним из значений X509ContentType .
FormatDate(DateTime)

Преобразует указанную дату и время в строку.
GetCertHash()

Возвращает хэш-значение для сертификата X.509v3 в виде массива байтов.
GetCertHash(HashAlgorithmName)

Возвращает хэш-значение для сертификата X.509v3, вычисляемого с помощью указанного алгоритма хэша шифрования.
GetCertHashString()

Возвращает хэш-значение SHA-1 для сертификата 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[], SecureString, X509KeyStorageFlags)

Заполняет X509Certificate объект с помощью данных из массива байтов, пароля и флага хранилища ключей.
Import(Byte[], String, X509KeyStorageFlags)

Заполняет X509Certificate объект данными из массива байтов, пароля и флагов для определения импорта закрытого ключа.
Import(Byte[])

Заполняет объект данными X509Certificate из массива байтов.
Import(String, SecureString, X509KeyStorageFlags)

Заполняет X509Certificate объект информацией из файла сертификата, пароля и флага хранилища ключей.
Import(String, String, X509KeyStorageFlags)

Заполняет X509Certificate объект сведениями из файла сертификата, пароля и X509KeyStorageFlags значения.
Import(String)

Заполняет X509Certificate объект сведениями из файла сертификата.
MemberwiseClone()

Создает неглубокую копию текущей Object.

(Унаследовано от Object)
Reset()

Сбрасывает состояние X509Certificate2 объекта.
ToString()

Возвращает строковое представление текущего X509Certificate объекта.
ToString(Boolean)

Возвращает строковое представление текущего X509Certificate объекта с дополнительными сведениями, если они указаны.
TryGetCertHash(HashAlgorithmName, Span<Byte>, Int32)

Пытается создать "отпечаток" для сертификата, хэшируя закодированное представление сертификата с указанным хэш-алгоритмом.

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

Имя Описание
IDeserializationCallback.OnDeserialization(Object)

ISerializable Реализует интерфейс и вызывается событием десериализации при завершении десериализации.
ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Получает сведения сериализации со всеми данными, необходимыми для повторного создания экземпляра текущего X509Certificate объекта.

Применяется к