X509Certificate Класс

Определение

Предоставляет методы, помогающие использовать сертификаты 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
Наследование
X509Certificate
Производный
Атрибуты
Реализации

Примеры

В следующем примере загружается сертификат 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.

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)

Экспортирует текущий объект 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.

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