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

Определение

Инициализирует новый экземпляр класса X509Certificate.Initializes a new instance of the X509Certificate class.

Перегрузки

X509Certificate()

Инициализирует новый экземпляр класса X509Certificate.Initializes a new instance of the X509Certificate class.

X509Certificate(String, SecureString, X509KeyStorageFlags)

Инициализирует новый экземпляр класса X509Certificate с использованием имени файла сертификата, пароля и флага хранилища ключа.Initializes a new instance of the X509Certificate class using a certificate file name, a password, and a key storage flag.

X509Certificate(Byte[], String, X509KeyStorageFlags)

Инициализирует новый экземпляр класса X509Certificate с использованием массива байтов, пароля и флага хранилища ключей.Initializes a new instance of the X509Certificate class using a byte array, a password, and a key storage flag.

X509Certificate(Byte[], SecureString, X509KeyStorageFlags)

Инициализирует новый экземпляр класса X509Certificate с использованием массива байтов, пароля и флага хранилища ключей.Initializes a new instance of the X509Certificate class using a byte array, a password, and a key storage flag.

X509Certificate(String, String)

Инициализирует новый экземпляр класса X509Certificate, именем подписанного файла PKCS7 и паролем для доступа к сертификату.Initializes a new instance of the X509Certificate class using the name of a PKCS7 signed file and a password to access the certificate.

X509Certificate(String, SecureString)

Инициализирует новый экземпляр класса X509Certificate с использованием имени файла сертификата и пароля.Initializes a new instance of the X509Certificate class using a certificate file name and a password.

X509Certificate(SerializationInfo, StreamingContext)

Инициализирует новый экземпляр класса X509Certificate с помощью объекта SerializationInfo и структуры StreamingContext.Initializes a new instance of the X509Certificate class using a SerializationInfo object and a StreamingContext structure.

X509Certificate(String, String, X509KeyStorageFlags)

Инициализирует новый экземпляр класса X509Certificate, именем подписанного файла PKCS7 и паролем для доступа к сертификату и флагом хранилища ключей.Initializes a new instance of the X509Certificate class using the name of a PKCS7 signed file, a password to access the certificate, and a key storage flag.

X509Certificate(Byte[], SecureString)

Инициализирует новый экземпляр класса X509Certificate с использованием массива байтов и пароля.Initializes a new instance of the X509Certificate class using a byte array and a password.

X509Certificate(String)

Инициализирует новый экземпляр класса X509Certificate именем подписанного файла PKCS7.Initializes a new instance of the X509Certificate class using the name of a PKCS7 signed file.

X509Certificate(X509Certificate)

Инициализирует новый экземпляр класса X509Certificate с помощью другого класса X509Certificate.Initializes a new instance of the X509Certificate class using another X509Certificate class.

X509Certificate(IntPtr)

Инициализирует новый экземпляр класса X509Certificate с помощью дескриптора неуправляемой структуры PCCERT_CONTEXT.Initializes a new instance of the X509Certificate class using a handle to an unmanaged PCCERT_CONTEXT structure.

X509Certificate(Byte[])

Инициализирует новый класс X509Certificate, определенный из последовательности байтов, представляющих сертификат X.509v3.Initializes a new instance of the X509Certificate class defined from a sequence of bytes representing an X.509v3 certificate.

X509Certificate(Byte[], String)

Инициализирует новый экземпляр класса X509Certificate с использованием массива байтов и пароля.Initializes a new instance of the X509Certificate class using a byte array and a password.

X509Certificate()

Инициализирует новый экземпляр класса X509Certificate.Initializes a new instance of the X509Certificate class.

public:
 X509Certificate();
public X509Certificate ();
Public Sub New ()

Комментарии

ASN. 1 DER — это единственный формат сертификата, поддерживаемый этим классом.ASN.1 DER is the only certificate format supported by this class.

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

X509Certificate(String, SecureString, X509KeyStorageFlags)

Важно!

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

Инициализирует новый экземпляр класса X509Certificate с использованием имени файла сертификата, пароля и флага хранилища ключа.Initializes a new instance of the X509Certificate class using a certificate file name, a password, and a key storage flag.

public:
 X509Certificate(System::String ^ fileName, System::Security::SecureString ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
public X509Certificate (string fileName, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
public X509Certificate (string fileName, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
public X509Certificate (string fileName, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
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

Имя файла сертификата.The name of a certificate file.

password
SecureString

Пароль для доступа к данным сертификата X.509.The password required to access the X.509 certificate data.

keyStorageFlags
X509KeyStorageFlags

Поразрядное сочетание значений перечисления, определяющих, где и как следует импортировать сертификат.A bitwise combination of the enumeration values that control where and how to import the certificate.

Атрибуты

Исключения

Произошла ошибка сертификата.An error with the certificate occurs. Пример:For example:

– Заданный файл сертификата не существует.- The certificate file does not exist.

— Сертификат недействителен.- The certificate is invalid.

— Пароль сертификата неверен.- The certificate's password is incorrect.

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

Комментарии

Если X509Certificate сертификат создается путем указания хранилища файлов с подписью PKCS7 для fileName , X509Certificate создается для сертификата, который подписал хранилище, а не для всех сертификатов в хранилище.If you create an X509Certificate certificate by specifying a PKCS7 signed file store for fileName, the X509Certificate is created for the certificate that signed the store rather than for any of the certificates within the store.

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

X509Certificate(Byte[], String, X509KeyStorageFlags)

Инициализирует новый экземпляр класса X509Certificate с использованием массива байтов, пароля и флага хранилища ключей.Initializes a new instance of the X509Certificate class using a byte array, a password, and a key storage flag.

public:
 X509Certificate(cli::array <System::Byte> ^ rawData, System::String ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);
public X509Certificate (byte[] rawData, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
public X509Certificate (byte[] rawData, string password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
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.A byte array containing data from an X.509 certificate.

password
String

Пароль для доступа к данным сертификата X.509.The password required to access the X.509 certificate data.

keyStorageFlags
X509KeyStorageFlags

Поразрядное сочетание значений перечисления, определяющих, где и как следует импортировать сертификат.A bitwise combination of the enumeration values that control where and how to import the certificate.

Исключения

Произошла ошибка сертификата.An error with the certificate occurs. Пример:For example:

– Заданный файл сертификата не существует.- The certificate file does not exist.

— Сертификат недействителен.- The certificate is invalid.

— Пароль сертификата неверен.- The certificate's password is incorrect.

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

-или--or- Длина параметра rawData равна 0.The length of the rawData parameter is 0.

Комментарии

Этот конструктор создает новый X509Certificate объект, используя массив байтов, пароль, необходимый для доступа к данным сертификата, и флаг хранилища ключей.This constructor creates a new X509Certificate object using a byte array, a password that is needed to access the certificate data, and a key storage flag. При вызове этого конструктора с правильным паролем закрытый ключ расшифровывается и сохраняется в поставщике служб шифрования Microsoft Cryptographic API (CSP).Calling this constructor with the correct password decrypts the private key and saves it to a Microsoft Cryptographic API Cryptographic Service Provider (CSP).

X509KeyStorageFlagsЗначение можно использовать для управления местом и способом импорта закрытого ключа.The X509KeyStorageFlags value can be used to control where and how the private key is imported.

ASN. 1 DER — это единственный формат сертификата, поддерживаемый этим классом.ASN.1 DER is the only certificate format supported by this class.

Важно!

Никогда не следует жестко кодировать пароль в исходном коде.Never hard code a password within your source code. Жестко запрограммированные пароли можно получить из сборки с помощью Ildasm.exe (IL-файла), шестнадцатеричного редактора или путем простого открытия сборки в текстовом редакторе, например Notepad.exe.Hard-coded passwords can be retrieved from an assembly using the Ildasm.exe (IL Disassembler), a hex editor, or by simply opening the assembly in a text editor such as Notepad.exe.

Если X509Certificate сертификат создается путем указания хранилища файлов с подписью PKCS7 для rawData , X509Certificate создается для сертификата, который подписал хранилище, а не для всех сертификатов в хранилище.If you create an X509Certificate certificate by specifying a PKCS7 signed file store for rawData, the X509Certificate is created for the certificate that signed the store rather than for any of the certificates within the store.

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

X509Certificate(Byte[], SecureString, X509KeyStorageFlags)

Важно!

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

Инициализирует новый экземпляр класса X509Certificate с использованием массива байтов, пароля и флага хранилища ключей.Initializes a new instance of the X509Certificate class using a byte array, a password, and a key storage flag.

public:
 X509Certificate(cli::array <System::Byte> ^ rawData, System::Security::SecureString ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
public X509Certificate (byte[] rawData, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
public X509Certificate (byte[] rawData, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
public X509Certificate (byte[] rawData, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> System.Security.Cryptography.X509Certificates.X509Certificate
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.A byte array that contains data from an X.509 certificate.

password
SecureString

Пароль для доступа к данным сертификата X.509.The password required to access the X.509 certificate data.

keyStorageFlags
X509KeyStorageFlags

Поразрядное сочетание значений перечисления, определяющих, где и как следует импортировать сертификат.A bitwise combination of the enumeration values that control where and how to import the certificate.

Атрибуты

Исключения

Произошла ошибка сертификата.An error with the certificate occurs. Пример:For example:

– Заданный файл сертификата не существует.- The certificate file does not exist.

— Сертификат недействителен.- The certificate is invalid.

— Пароль сертификата неверен.- The certificate's password is incorrect.

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

-или--or- Длина параметра rawData равна 0.The length of the rawData parameter is 0.

Комментарии

При вызове этого конструктора с правильным паролем закрытый ключ расшифровывается и сохраняется в поставщике служб шифрования Microsoft Cryptographic API (CSP).Calling this constructor with the correct password decrypts the private key and saves it to a Microsoft Cryptographic API Cryptographic Service Provider (CSP).

ASN. 1 DER — это единственный формат сертификата, поддерживаемый этим классом.ASN.1 DER is the only certificate format supported by this class.

Важно!

Никогда не следует жестко кодировать пароль в исходном коде.Never hard code a password within your source code. Жестко запрограммированные пароли можно получить из сборки с помощью Ildasm.exe (IL-файла), шестнадцатеричного редактора или путем простого открытия сборки в текстовом редакторе, например Notepad.exe.Hard-coded passwords can be retrieved from an assembly using the Ildasm.exe (IL Disassembler), a hex editor, or by simply opening the assembly in a text editor such as Notepad.exe.

Если X509Certificate сертификат создается путем указания хранилища файлов с подписью PKCS7 для rawData , X509Certificate создается для сертификата, который подписал хранилище, а не для всех сертификатов в хранилище.If you create an X509Certificate certificate by specifying a PKCS7 signed file store for rawData, the X509Certificate is created for the certificate that signed the store rather than for any of the certificates within the store.

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

X509Certificate(String, String)

Инициализирует новый экземпляр класса X509Certificate, именем подписанного файла PKCS7 и паролем для доступа к сертификату.Initializes a new instance of the X509Certificate class using the name of a PKCS7 signed file and a password to access the certificate.

public:
 X509Certificate(System::String ^ fileName, System::String ^ password);
public X509Certificate (string fileName, string? password);
public X509Certificate (string fileName, string password);
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.The name of a PKCS7 signed file.

password
String

Пароль для доступа к данным сертификата X.509.The password required to access the X.509 certificate data.

Исключения

Произошла ошибка сертификата.An error with the certificate occurs. Пример:For example:

– Заданный файл сертификата не существует.- The certificate file does not exist.

— Сертификат недействителен.- The certificate is invalid.

— Пароль сертификата неверен.- The certificate's password is incorrect.

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

Комментарии

ASN. 1 DER — это единственный формат сертификата, поддерживаемый этим классом.ASN.1 DER is the only certificate format supported by this class. При вызове этого конструктора с правильным паролем закрытый ключ расшифровывается и сохраняется в контейнере ключей.Calling this constructor with the correct password decrypts the private key and saves it to a key container.

Если X509Certificate сертификат создается путем указания хранилища файлов с подписью PKCS7 для fileName , X509Certificate создается для сертификата, который подписал хранилище, а не для всех сертификатов в хранилище.If you create an X509Certificate certificate by specifying a PKCS7 signed file store for fileName, the X509Certificate is created for the certificate that signed the store rather than for any of the certificates within the store.

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

X509Certificate(String, SecureString)

Важно!

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

Инициализирует новый экземпляр класса X509Certificate с использованием имени файла сертификата и пароля.Initializes a new instance of the X509Certificate class using a certificate file name and a password.

public:
 X509Certificate(System::String ^ fileName, System::Security::SecureString ^ password);
[System.CLSCompliant(false)]
public X509Certificate (string fileName, System.Security.SecureString? password);
[System.CLSCompliant(false)]
public X509Certificate (string fileName, System.Security.SecureString password);
public X509Certificate (string fileName, System.Security.SecureString password);
[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate : string * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
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

Имя файла сертификата.The name of a certificate file.

password
SecureString

Пароль для доступа к данным сертификата X.509.The password required to access the X.509 certificate data.

Атрибуты

Исключения

Произошла ошибка сертификата.An error with the certificate occurs. Пример:For example:

– Заданный файл сертификата не существует.- The certificate file does not exist.

— Сертификат недействителен.- The certificate is invalid.

— Пароль сертификата неверен.- The certificate's password is incorrect.

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

Комментарии

ASN. 1 DER — это единственный формат сертификата, поддерживаемый этим классом.ASN.1 DER is the only certificate format supported by this class. При вызове этого конструктора с правильным паролем закрытый ключ расшифровывается и сохраняется в контейнере ключей.Calling this constructor with the correct password decrypts the private key and saves it to a key container.

Важно!

Никогда не следует жестко кодировать пароль в исходном коде.Never hard code a password within your source code. Жестко запрограммированные пароли можно получить из сборки с помощью Ildasm.exe (IL-файла), шестнадцатеричного редактора или путем простого открытия сборки в текстовом редакторе, например Notepad.exe.Hard-coded passwords can be retrieved from an assembly using the Ildasm.exe (IL Disassembler), a hex editor, or by simply opening the assembly in a text editor such as Notepad.exe.

Если X509Certificate сертификат создается путем указания хранилища файлов с подписью PKCS7 для fileName , X509Certificate создается для сертификата, который подписал хранилище, а не для всех сертификатов в хранилище.If you create an X509Certificate certificate by specifying a PKCS7 signed file store for fileName, the X509Certificate is created for the certificate that signed the store rather than for any of the certificates within the store.

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

X509Certificate(SerializationInfo, StreamingContext)

Инициализирует новый экземпляр класса X509Certificate с помощью объекта SerializationInfo и структуры StreamingContext.Initializes a new instance of the X509Certificate class using a SerializationInfo object and a StreamingContext structure.

public:
 X509Certificate(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);
public X509Certificate (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
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, описывающий информацию о сериализации.A SerializationInfo object that describes serialization information.

context
StreamingContext

СтруктураStreamingContext, описывающая способ выполнения сериализации.A StreamingContext structure that describes how serialization should be performed.

Исключения

Произошла ошибка сертификата.An error with the certificate occurs. Пример:For example:

– Заданный файл сертификата не существует.- The certificate file does not exist.

— Сертификат недействителен.- The certificate is invalid.

— Пароль сертификата неверен.- The certificate's password is incorrect.

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

X509Certificate(String, String, X509KeyStorageFlags)

Инициализирует новый экземпляр класса X509Certificate, именем подписанного файла PKCS7 и паролем для доступа к сертификату и флагом хранилища ключей.Initializes a new instance of the X509Certificate class using the name of a PKCS7 signed file, a password to access the certificate, and a key storage flag.

public:
 X509Certificate(System::String ^ fileName, System::String ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);
public X509Certificate (string fileName, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
public X509Certificate (string fileName, string password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
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.The name of a PKCS7 signed file.

password
String

Пароль для доступа к данным сертификата X.509.The password required to access the X.509 certificate data.

keyStorageFlags
X509KeyStorageFlags

Поразрядное сочетание значений перечисления, определяющих, где и как следует импортировать сертификат.A bitwise combination of the enumeration values that control where and how to import the certificate.

Исключения

Произошла ошибка сертификата.An error with the certificate occurs. Пример:For example:

– Заданный файл сертификата не существует.- The certificate file does not exist.

— Сертификат недействителен.- The certificate is invalid.

— Пароль сертификата неверен.- The certificate's password is incorrect.

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

Комментарии

Если X509Certificate сертификат создается путем указания хранилища файлов с подписью PKCS7 для fileName , X509Certificate создается для сертификата, который подписал хранилище, а не для всех сертификатов в хранилище.If you create an X509Certificate certificate by specifying a PKCS7 signed file store for fileName, the X509Certificate is created for the certificate that signed the store rather than for any of the certificates within the store.

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

X509Certificate(Byte[], SecureString)

Важно!

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

Инициализирует новый экземпляр класса X509Certificate с использованием массива байтов и пароля.Initializes a new instance of the X509Certificate class using a byte array and a password.

public:
 X509Certificate(cli::array <System::Byte> ^ rawData, System::Security::SecureString ^ password);
[System.CLSCompliant(false)]
public X509Certificate (byte[] rawData, System.Security.SecureString? password);
[System.CLSCompliant(false)]
public X509Certificate (byte[] rawData, System.Security.SecureString password);
public X509Certificate (byte[] rawData, System.Security.SecureString password);
[<System.CLSCompliant(false)>]
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] * System.Security.SecureString -> System.Security.Cryptography.X509Certificates.X509Certificate
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.A byte array that contains data from an X.509 certificate.

password
SecureString

Пароль для доступа к данным сертификата X.509.The password required to access the X.509 certificate data.

Атрибуты

Исключения

Произошла ошибка сертификата.An error with the certificate occurs. Пример:For example:

– Заданный файл сертификата не существует.- The certificate file does not exist.

— Сертификат недействителен.- The certificate is invalid.

— Пароль сертификата неверен.- The certificate's password is incorrect.

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

-или--or- Длина параметра rawData равна 0.The length of the rawData parameter is 0.

Комментарии

ASN. 1 DER — это единственный формат сертификата, поддерживаемый этим классом.ASN.1 DER is the only certificate format supported by this class.

Важно!

Никогда не следует жестко кодировать пароль в исходном коде.Never hard code a password within your source code. Жестко запрограммированные пароли можно получить из сборки с помощью Ildasm.exe (IL-файла), шестнадцатеричного редактора или путем простого открытия сборки в текстовом редакторе, например Notepad.exe.Hard-coded passwords can be retrieved from an assembly using the Ildasm.exe (IL Disassembler), a hex editor, or by simply opening the assembly in a text editor such as Notepad.exe.

Если X509Certificate сертификат создается путем указания хранилища файлов с подписью PKCS7 для rawData , X509Certificate создается для сертификата, который подписал хранилище, а не для всех сертификатов в хранилище.If you create an X509Certificate certificate by specifying a PKCS7 signed file store for rawData, the X509Certificate is created for the certificate that signed the store rather than for any of the certificates within the store.

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

X509Certificate(String)

Инициализирует новый экземпляр класса X509Certificate именем подписанного файла PKCS7.Initializes a new instance of the X509Certificate class using the name of a PKCS7 signed file.

public:
 X509Certificate(System::String ^ fileName);
public X509Certificate (string fileName);
new System.Security.Cryptography.X509Certificates.X509Certificate : string -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (fileName As String)

Параметры

fileName
String

Имя подписанного файла PKCS7.The name of a PKCS7 signed file.

Исключения

Произошла ошибка сертификата.An error with the certificate occurs. Пример:For example:

– Заданный файл сертификата не существует.- The certificate file does not exist.

— Сертификат недействителен.- The certificate is invalid.

— Пароль сертификата неверен.- The certificate's password is incorrect.

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

Примеры

В следующем примере из файла загружается сертификат X. 509, вызывается ToString метод, а результаты выводятся на консоль.The following example loads an X.509 certificate from a file, calls the ToString method, and displays the results to the console.

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 — это единственный формат сертификата, поддерживаемый этим классом.ASN.1 DER is the only certificate format supported by this class.

Если X509Certificate сертификат создается путем указания хранилища файлов с подписью PKCS7 для fileName , X509Certificate создается для сертификата, который подписал хранилище, а не для всех сертификатов в хранилище.If you create an X509Certificate certificate by specifying a PKCS7 signed file store for fileName, the X509Certificate is created for the certificate that signed the store rather than for any of the certificates within the store.

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

X509Certificate(X509Certificate)

Инициализирует новый экземпляр класса X509Certificate с помощью другого класса X509Certificate.Initializes a new instance of the X509Certificate class using another X509Certificate class.

public:
 X509Certificate(System::Security::Cryptography::X509Certificates::X509Certificate ^ cert);
public X509Certificate (System.Security.Cryptography.X509Certificates.X509Certificate cert);
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, из которого инициализируется данный класс.A X509Certificate class from which to initialize this class.

Исключения

Произошла ошибка сертификата.An error with the certificate occurs. Пример:For example:

– Заданный файл сертификата не существует.- The certificate file does not exist.

— Сертификат недействителен.- The certificate is invalid.

— Пароль сертификата неверен.- The certificate's password is incorrect.

параметр cert имеет значение null;The value of the cert parameter is null.

Комментарии

ASN. 1 DER — это единственный формат сертификата, поддерживаемый этим классом.ASN.1 DER is the only certificate format supported by this class.

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

X509Certificate(IntPtr)

Инициализирует новый экземпляр класса X509Certificate с помощью дескриптора неуправляемой структуры PCCERT_CONTEXT.Initializes a new instance of the X509Certificate class using a handle to an unmanaged PCCERT_CONTEXT structure.

public:
 X509Certificate(IntPtr handle);
public X509Certificate (IntPtr handle);
[System.Security.SecurityCritical]
public X509Certificate (IntPtr handle);
new System.Security.Cryptography.X509Certificates.X509Certificate : nativeint -> System.Security.Cryptography.X509Certificates.X509Certificate
[<System.Security.SecurityCritical>]
new System.Security.Cryptography.X509Certificates.X509Certificate : nativeint -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (handle As IntPtr)

Параметры

handle
IntPtr

Дескриптор неуправляемой структуры PCCERT_CONTEXT.A handle to an unmanaged PCCERT_CONTEXT structure.

Атрибуты

Исключения

Произошла ошибка сертификата.An error with the certificate occurs. Пример:For example:

– Заданный файл сертификата не существует.- The certificate file does not exist.

— Сертификат недействителен.- The certificate is invalid.

— Пароль сертификата неверен.- The certificate's password is incorrect.

Параметр дескриптора не представляет допустимой структуры PCCERT_CONTEXT.The handle parameter does not represent a valid PCCERT_CONTEXT structure.

Комментарии

Этот конструктор создает новый X509Certificate объект, используя маркер для контекста сертификата Microsoft Cryptographic API PCCERT_CONTEXT .This constructor creates a new X509Certificate object using a handle for the Microsoft Cryptographic API certificate context, PCCERT_CONTEXT.

Важно!

Этот конструктор создает копию контекста сертификата.This constructor creates a copy of the certificate context. Не следует считать, что структура контекста, переданная конструктору, является допустимой. возможно, он был выпущен.Do not assume that the context structure you passed to the constructor is valid; it may have been released. Копию текущей структуры можно получить PCCERT_CONTEXT из Handle свойства, но она допустима только в течение времени существования X509Certificate объекта.You can get a copy of the current PCCERT_CONTEXT structure from the Handle property, but it is valid only during the lifetime of the X509Certificate object.

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

X509Certificate(Byte[])

Инициализирует новый класс X509Certificate, определенный из последовательности байтов, представляющих сертификат X.509v3.Initializes a new instance of the X509Certificate class defined from a sequence of bytes representing an X.509v3 certificate.

public:
 X509Certificate(cli::array <System::Byte> ^ data);
public X509Certificate (byte[] data);
new System.Security.Cryptography.X509Certificates.X509Certificate : byte[] -> System.Security.Cryptography.X509Certificates.X509Certificate
Public Sub New (data As Byte())

Параметры

data
Byte[]

Массив байтов, содержащий данные сертификата X.509.A byte array containing data from an X.509 certificate.

Исключения

Произошла ошибка сертификата.An error with the certificate occurs. Пример:For example:

– Заданный файл сертификата не существует.- The certificate file does not exist.

— Сертификат недействителен.- The certificate is invalid.

— Пароль сертификата неверен.- The certificate's password is incorrect.

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

-или--or- Длина параметра rawData равна 0.The length of the rawData parameter is 0.

Примеры

В следующем примере файл сертификата X. 509 загружается в X509Certificate объект, экспортируется в виде массива байтов, а затем массив байтов импортируется в другой X509Certificate объект.The following example loads an X.509 certificate file into an X509Certificate object, exports the certificate as a byte array, and then imports the byte array into another X509Certificate object.

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 — это единственный формат сертификата, поддерживаемый этим классом.ASN.1 DER is the only certificate format supported by this class.

Если X509Certificate сертификат создается путем указания хранилища файлов с подписью PKCS7 для data , X509Certificate создается для сертификата, который подписал хранилище, а не для всех сертификатов в хранилище.If you create an X509Certificate certificate by specifying a PKCS7 signed file store for data, the X509Certificate is created for the certificate that signed the store rather than for any of the certificates within the store.

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

X509Certificate(Byte[], String)

Инициализирует новый экземпляр класса X509Certificate с использованием массива байтов и пароля.Initializes a new instance of the X509Certificate class using a byte array and a password.

public:
 X509Certificate(cli::array <System::Byte> ^ rawData, System::String ^ password);
public X509Certificate (byte[] rawData, string? password);
public X509Certificate (byte[] rawData, string password);
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.A byte array containing data from an X.509 certificate.

password
String

Пароль для доступа к данным сертификата X.509.The password required to access the X.509 certificate data.

Исключения

Произошла ошибка сертификата.An error with the certificate occurs. Пример:For example:

– Заданный файл сертификата не существует.- The certificate file does not exist.

— Сертификат недействителен.- The certificate is invalid.

— Пароль сертификата неверен.- The certificate's password is incorrect.

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

-или--or- Длина параметра rawData равна 0.The length of the rawData parameter is 0.

Комментарии

ASN. 1 DER — это единственный формат сертификата, поддерживаемый этим классом.ASN.1 DER is the only certificate format supported by this class.

Важно!

Никогда не следует жестко кодировать пароль в исходном коде.Never hard code a password within your source code. Жестко запрограммированные пароли можно получить из сборки с помощью Ildasm.exe (IL-файла), шестнадцатеричного редактора или путем простого открытия сборки в текстовом редакторе, например Notepad.exe.Hard-coded passwords can be retrieved from an assembly using the Ildasm.exe (IL Disassembler), a hex editor, or by simply opening the assembly in a text editor such as Notepad.exe.

Если X509Certificate сертификат создается путем указания хранилища файлов с подписью PKCS7 для rawData , X509Certificate создается для сертификата, который подписал хранилище, а не для всех сертификатов в хранилище.If you create an X509Certificate certificate by specifying a PKCS7 signed file store for rawData, the X509Certificate is created for the certificate that signed the store rather than for any of the certificates within the store.

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