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

Определение

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

System.Security.Cryptography.X509Certificates

Сборка:

System.Security.Cryptography.dll

Инициализирует новый экземпляр класса X509Certificate.

Перегрузки

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

X509Certificate()

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

X509Certificate.cs

Внимание!

X509Certificate and X509Certificate2 are immutable. Use the appropriate constructor to create a new certificate.

Инициализирует новый экземпляр класса X509Certificate.

public:
 X509Certificate();

[System.Obsolete("X509Certificate and X509Certificate2 are immutable. Use the appropriate constructor to create a new certificate.", DiagnosticId="SYSLIB0026", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate ();

Public Sub New ()

Атрибуты

ObsoleteAttribute UnsupportedOSPlatformAttribute

Комментарии

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

X509Certificate(Byte[])

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

X509Certificate.cs

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

public:
 X509Certificate(cli::array <System::Byte> ^ data);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] data);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] -> System.Security.Cryptography.X509Certificates.X509Certificate

Public Sub New (data As Byte())

Параметры

data

Byte[]

Массив байтов, содержащий данные сертификата X.509.

Атрибуты

UnsupportedOSPlatformAttribute

Исключения

CryptographicException

Произошла ошибка сертификата. Пример:

• Файл сертификата не существует.

• Сертификат недействителен.

• Неправильный пароль сертификата.

ArgumentException

Параметр rawData имеет значение null.

-или-

Длина параметра rawData равна 0.

Примеры

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

using namespace System;
using namespace System::Security::Cryptography::X509Certificates;
int main()
{
   
   // The path to the certificate.
   String^ Certificate = L"test.pfx";
   
   // Load the certificate into an X509Certificate object.
   X509Certificate^ cert = gcnew X509Certificate( Certificate );
   array<Byte>^certData = cert->Export( X509ContentType::Cert );
   X509Certificate^ newCert = gcnew X509Certificate( certData );
   
   // Get the value.
   String^ resultsTrue = newCert->ToString( true );
   
   // Display the value to the console.
   Console::WriteLine( resultsTrue );
   
   // Get the value.
   String^ resultsFalse = newCert->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 = "test.pfx";

        // Load the certificate into an X509Certificate object.
        X509Certificate cert = new X509Certificate(Certificate);

        byte[] certData = cert.Export(X509ContentType.Cert);

        X509Certificate newCert = new X509Certificate(certData);

        // Get the value.
        string resultsTrue = newCert.ToString(true);

        // Display the value to the console.
        Console.WriteLine(resultsTrue);

        // Get the value.
        string resultsFalse = newCert.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 = "test.pfx"

        ' Load the certificate into an X509Certificate object.
        Dim cert As New X509Certificate(Certificate)


        Dim certData As Byte() = cert.Export(X509ContentType.Cert)

        Dim newCert As New X509Certificate(certData)

        ' Get the value.
        Dim resultsTrue As String = newCert.ToString(True)

        ' Display the value to the console.
        Console.WriteLine(resultsTrue)

        ' Get the value.
        Dim resultsFalse As String = newCert.ToString(False)

        ' Display the value to the console.
        Console.WriteLine(resultsFalse)

    End Sub
End Module

Комментарии

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

Если сертификат создается X509Certificate путем указания хранилища файлов, подписанного PKCS7 для data, X509Certificate создается для сертификата, подписавшего хранилище, а не для любого из сертификатов в хранилище.

X509Certificate(IntPtr)

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

X509Certificate.cs

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

public:
 X509Certificate(IntPtr handle);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (IntPtr handle);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : nativeint -> System.Security.Cryptography.X509Certificates.X509Certificate

Public Sub New (handle As IntPtr)

Параметры

handle

IntPtr

nativeint

Дескриптор неуправляемой структуры PCCERT_CONTEXT.

Атрибуты

UnsupportedOSPlatformAttribute

Исключения

CryptographicException

Произошла ошибка сертификата. Пример:

• Файл сертификата не существует.

• Сертификат недействителен.

• Неправильный пароль сертификата.

ArgumentException

Параметр дескриптора не представляет допустимой структуры PCCERT_CONTEXT.

Комментарии

Этот конструктор создает новый X509Certificate объект с помощью дескриптора для контекста сертификата API шифрования Майкрософт, PCCERT_CONTEXT.

Важно!

Этот конструктор создает копию контекста сертификата. Не предполагайте, что структура контекста, переданная в конструктор, является допустимой; Возможно, она была выпущена. Вы можете получить копию текущей PCCERT_CONTEXT структуры из Handle свойства , но она действительна только в течение времени существования X509Certificate объекта.

X509Certificate(X509Certificate)

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

X509Certificate.cs

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

public:
 X509Certificate(System::Security::Cryptography::X509Certificates::X509Certificate ^ cert);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (System.Security.Cryptography.X509Certificates.X509Certificate cert);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Security.Cryptography.X509Certificates.X509Certificate

Public Sub New (cert As X509Certificate)

Параметры

cert

X509Certificate

Класс X509Certificate, из которого инициализируется данный класс.

Атрибуты

UnsupportedOSPlatformAttribute

Исключения

CryptographicException

Произошла ошибка сертификата. Пример:

• Файл сертификата не существует.

• Сертификат недействителен.

• Неправильный пароль сертификата.

ArgumentNullException

параметр cert имеет значение null;

Комментарии

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

X509Certificate(String)

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

X509Certificate.cs

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

public:
 X509Certificate(System::String ^ fileName);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string -> System.Security.Cryptography.X509Certificates.X509Certificate

Public Sub New (fileName As String)

Параметры

fileName

String

Имя подписанного файла PKCS7.

Атрибуты

UnsupportedOSPlatformAttribute

Исключения

CryptographicException

Произошла ошибка сертификата. Пример:

• Файл сертификата не существует.

• Сертификат недействителен.

• Неправильный пароль сертификата.

ArgumentException

Параметр fileName имеет значение null.

Примеры

Следующий пример загружает сертификат 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 — это единственный формат сертификата, поддерживаемый этим классом.

Если сертификат создается X509Certificate путем указания хранилища файлов, подписанного PKCS7 для fileName, X509Certificate создается для сертификата, подписавшего хранилище, а не для любого из сертификатов в хранилище.

X509Certificate(Byte[], SecureString)

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

X509Certificate.cs

Важно!

Этот API несовместим с CLS.

Инициализирует новый экземпляр класса X509Certificate с использованием массива байтов и пароля.

public:
 X509Certificate(cli::array <System::Byte> ^ rawData, System::Security::SecureString ^ password);

[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] rawData, System.Security.SecureString? password);

[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate

Public Sub New (rawData As Byte(), password As SecureString)

Параметры

rawData

Byte[]

Массив байтов, содержащий данные из сертификата X.509.

password

SecureString

Пароль для доступа к данным сертификата X.509.

Атрибуты

CLSCompliantAttribute UnsupportedOSPlatformAttribute

Исключения

CryptographicException

Произошла ошибка сертификата. Пример:

• Файл сертификата не существует.

• Сертификат недействителен.

• Неправильный пароль сертификата.

ArgumentException

Параметр rawData имеет значение null.

-или-

Длина параметра rawData равна 0.

Комментарии

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

Важно!

Никогда не жестко кодируйте пароль в исходном коде. Жестко заданные пароли можно получить из сборки с помощью Ildasm.exe (дизассемблер IL), шестнадцатеричного редактора или просто открыв сборку в текстовом редакторе, например Notepad.exe.

Если сертификат создается X509Certificate путем указания хранилища файлов, подписанного PKCS7 для rawData, X509Certificate создается для сертификата, подписавшего хранилище, а не для любого из сертификатов в хранилище.

X509Certificate(Byte[], String)

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

X509Certificate.cs

Инициализирует новый экземпляр класса X509Certificate с использованием массива байтов и пароля.

public:
 X509Certificate(cli::array <System::Byte> ^ rawData, System::String ^ password);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] rawData, string? password);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * string -> System.Security.Cryptography.X509Certificates.X509Certificate

Public Sub New (rawData As Byte(), password As String)

Параметры

rawData

Byte[]

Массив байтов, содержащий данные сертификата X.509.

password

String

Пароль для доступа к данным сертификата X.509.

Атрибуты

UnsupportedOSPlatformAttribute

Исключения

CryptographicException

Произошла ошибка сертификата. Пример:

• Файл сертификата не существует.

• Сертификат недействителен.

• Неправильный пароль сертификата.

ArgumentException

Параметр rawData имеет значение null.

-или-

Длина параметра rawData равна 0.

Комментарии

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

Важно!

Никогда не жестко кодируйте пароль в исходном коде. Жестко заданные пароли можно получить из сборки с помощью Ildasm.exe (дизассемблер IL), шестнадцатеричного редактора или просто открыв сборку в текстовом редакторе, например Notepad.exe.

Если сертификат создается X509Certificate путем указания хранилища файлов, подписанного PKCS7 для rawData, X509Certificate создается для сертификата, подписавшего хранилище, а не для любого из сертификатов в хранилище.

X509Certificate(SerializationInfo, StreamingContext)

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

X509Certificate.cs

Внимание!

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

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

public:
 X509Certificate(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public X509Certificate (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Security.Cryptography.X509Certificates.X509Certificate

Public Sub New (info As SerializationInfo, context As StreamingContext)

Параметры

info

SerializationInfo

Объект SerializationInfo, описывающий информацию о сериализации.

context

StreamingContext

СтруктураStreamingContext, описывающая способ выполнения сериализации.

Атрибуты

ObsoleteAttribute

Исключения

CryptographicException

Произошла ошибка сертификата. Пример:

• Файл сертификата не существует.

• Сертификат недействителен.

• Неправильный пароль сертификата.

X509Certificate(String, SecureString)

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

X509Certificate.cs

Важно!

Этот API несовместим с CLS.

Инициализирует новый экземпляр класса X509Certificate с использованием имени файла сертификата и пароля.

public:
 X509Certificate(System::String ^ fileName, System::Security::SecureString ^ password);

[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName, System.Security.SecureString? password);

[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate

Public Sub New (fileName As String, password As SecureString)

Параметры

fileName

String

Имя файла сертификата.

password

SecureString

Пароль для доступа к данным сертификата X.509.

Атрибуты

CLSCompliantAttribute UnsupportedOSPlatformAttribute

Исключения

CryptographicException

Произошла ошибка сертификата. Пример:

• Файл сертификата не существует.

• Сертификат недействителен.

• Неправильный пароль сертификата.

ArgumentException

Параметр fileName имеет значение null.

Комментарии

ASN.1 DER — это единственный формат сертификата, поддерживаемый этим классом. Вызов этого конструктора с правильным паролем расшифровывает закрытый ключ и сохраняет его в контейнер ключей.

Важно!

Никогда не жестко кодируйте пароль в исходном коде. Жестко заданные пароли можно получить из сборки с помощью Ildasm.exe (дизассемблер IL), шестнадцатеричного редактора или просто открыв сборку в текстовом редакторе, например Notepad.exe.

Если сертификат создается X509Certificate путем указания хранилища файлов, подписанного PKCS7 для fileName, X509Certificate создается для сертификата, подписавшего хранилище, а не для любого из сертификатов в хранилище.

X509Certificate(String, String)

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

X509Certificate.cs

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

public:
 X509Certificate(System::String ^ fileName, System::String ^ password);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName, string? password);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * string -> System.Security.Cryptography.X509Certificates.X509Certificate

Public Sub New (fileName As String, password As String)

Параметры

fileName

String

Имя подписанного файла PKCS7.

password

String

Пароль для доступа к данным сертификата X.509.

Атрибуты

UnsupportedOSPlatformAttribute

Исключения

CryptographicException

Произошла ошибка сертификата. Пример:

• Файл сертификата не существует.

• Сертификат недействителен.

• Неправильный пароль сертификата.

ArgumentException

Параметр fileName имеет значение null.

Комментарии

ASN.1 DER — это единственный формат сертификата, поддерживаемый этим классом. Вызов этого конструктора с правильным паролем расшифровывает закрытый ключ и сохраняет его в контейнер ключей.

Если сертификат создается X509Certificate путем указания хранилища файлов, подписанного PKCS7 для fileName, X509Certificate создается для сертификата, подписавшего хранилище, а не для любого из сертификатов в хранилище.

X509Certificate(Byte[], SecureString, X509KeyStorageFlags)

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

X509Certificate.cs

Важно!

Этот API несовместим с CLS.

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

public:
 X509Certificate(cli::array <System::Byte> ^ rawData, System::Security::SecureString ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);

[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] rawData, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate

Public Sub New (rawData As Byte(), password As SecureString, keyStorageFlags As X509KeyStorageFlags)

Параметры

rawData

Byte[]

Массив байтов, содержащий данные из сертификата X.509.

password

SecureString

Пароль для доступа к данным сертификата X.509.

keyStorageFlags

X509KeyStorageFlags

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

Атрибуты

CLSCompliantAttribute UnsupportedOSPlatformAttribute

Исключения

CryptographicException

Произошла ошибка сертификата. Пример:

• Файл сертификата не существует.

• Сертификат недействителен.

• Неправильный пароль сертификата.

ArgumentException

Параметр rawData имеет значение null.

-или-

Длина параметра rawData равна 0.

Комментарии

Вызов этого конструктора с правильным паролем расшифровывает закрытый ключ и сохраняет его в поставщике служб шифрования (CSP) Api шифрования Майкрософт.

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

Важно!

Никогда не жестко кодируйте пароль в исходном коде. Жестко заданные пароли можно получить из сборки с помощью Ildasm.exe (дизассемблер IL), шестнадцатеричного редактора или просто открыв сборку в текстовом редакторе, например Notepad.exe.

Если сертификат создается X509Certificate путем указания хранилища файлов, подписанного PKCS7 для rawData, X509Certificate создается для сертификата, подписавшего хранилище, а не для любого из сертификатов в хранилище.

X509Certificate(Byte[], String, X509KeyStorageFlags)

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

X509Certificate.cs

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

public:
 X509Certificate(cli::array <System::Byte> ^ rawData, System::String ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (byte[] rawData, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate

Public Sub New (rawData As Byte(), password As String, keyStorageFlags As X509KeyStorageFlags)

Параметры

rawData

Byte[]

Массив байтов, содержащий данные сертификата X.509.

password

String

Пароль для доступа к данным сертификата X.509.

keyStorageFlags

X509KeyStorageFlags

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

Атрибуты

UnsupportedOSPlatformAttribute

Исключения

CryptographicException

Произошла ошибка сертификата. Пример:

• Файл сертификата не существует.

• Сертификат недействителен.

• Неправильный пароль сертификата.

ArgumentException

Параметр rawData имеет значение null.

-или-

Длина параметра rawData равна 0.

Комментарии

Этот конструктор создает новый X509Certificate объект с помощью массива байтов, пароля, необходимого для доступа к данным сертификата, и флага хранилища ключей. Вызов этого конструктора с правильным паролем расшифровывает закрытый ключ и сохраняет его в поставщике служб шифрования (CSP) Api шифрования Майкрософт.

Значение X509KeyStorageFlags можно использовать для управления тем, где и как импортируется закрытый ключ.

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

Важно!

Никогда не жестко кодируйте пароль в исходном коде. Жестко заданные пароли можно получить из сборки с помощью Ildasm.exe (дизассемблер IL), шестнадцатеричного редактора или просто открыв сборку в текстовом редакторе, например Notepad.exe.

Если сертификат создается X509Certificate путем указания хранилища файлов, подписанного PKCS7 для rawData, X509Certificate создается для сертификата, подписавшего хранилище, а не для любого из сертификатов в хранилище.

X509Certificate(String, SecureString, X509KeyStorageFlags)

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

X509Certificate.cs

Важно!

Этот API несовместим с CLS.

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

public:
 X509Certificate(System::String ^ fileName, System::Security::SecureString ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);

[System.CLSCompliant(false)]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[<System.CLSCompliant(false)>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate

Public Sub New (fileName As String, password As SecureString, keyStorageFlags As X509KeyStorageFlags)

Параметры

fileName

String

Имя файла сертификата.

password

SecureString

Пароль для доступа к данным сертификата X.509.

keyStorageFlags

X509KeyStorageFlags

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

Атрибуты

CLSCompliantAttribute UnsupportedOSPlatformAttribute

Исключения

CryptographicException

Произошла ошибка сертификата. Пример:

• Файл сертификата не существует.

• Сертификат недействителен.

• Неправильный пароль сертификата.

ArgumentException

Параметр fileName имеет значение null.

Комментарии

При создании X509Certificate сертификата путем указания хранилища файлов, подписанного PKCS7 для fileName, X509Certificate создается для сертификата, подписавшего хранилище, а не для любого из сертификатов в хранилище.

X509Certificate(String, String, X509KeyStorageFlags)

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

X509Certificate.cs

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

public:
 X509Certificate(System::String ^ fileName, System::String ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public X509Certificate (string fileName, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate

Public Sub New (fileName As String, password As String, keyStorageFlags As X509KeyStorageFlags)

Параметры

fileName

String

Имя подписанного файла PKCS7.

password

String

Пароль для доступа к данным сертификата X.509.

keyStorageFlags

X509KeyStorageFlags

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

Атрибуты

UnsupportedOSPlatformAttribute

Исключения

CryptographicException

Произошла ошибка сертификата. Пример:

• Файл сертификата не существует.

• Сертификат недействителен.

• Неправильный пароль сертификата.

ArgumentException

Параметр fileName имеет значение null.

Комментарии

При создании X509Certificate сертификата путем указания хранилища файлов, подписанного PKCS7 для fileName, X509Certificate создается для сертификата, подписавшего хранилище, а не для любого из сертификатов в хранилище.