X509Certificate Класс

Ссылка

Определение

Пространство имен:: System.Security.Cryptography.X509Certificates

Сборка:: System.Security.Cryptography.X509Certificates.dll

Сборка:: System.Security.Cryptography.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Исходный код:: X509Certificate.cs

Исходный код:: X509Certificate.cs

Исходный код:: X509Certificate.cs

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

Public Class X509Certificate
Implements IDeserializationCallback, IDisposable, ISerializable

Public Class X509Certificate
Implements IDisposable

Public Class X509Certificate

Public Class X509Certificate
Implements IDeserializationCallback, ISerializable

Наследование: Object
X509Certificate

Производный: System.Security.Cryptography.X509Certificates.X509Certificate2

Атрибуты: SerializableAttribute ComVisibleAttribute

Реализации: 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

Начиная с .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)	Инициализирует новый экземпляр класса X509Certificate с помощью другого класса X509Certificate.

Свойства

Handle	Получает дескриптор контекста сертификата API 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(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()	Возвращает хэш-значение 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[], 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.

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

Поделиться через