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 создается для сертификата, подписавшего хранилище, а не для любого из сертификатов в хранилище.