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);
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 сертификат, указав для fileNameхранилище файлов с подписью PKCS7, 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.

Безопасность

FileIOPermission
для разрешения на чтение файла, описываемого параметром fileName.for permission to read the file described by the fileName parameter. Действие безопасности: Demand.Security action: Demand. Связанное перечисление: ReadAssociated enumeration: Read

KeyContainerPermission
для разрешения на создание контейнера ключей.for permission to create a key container. Действие безопасности: Demand.Security action: Demand. Связанное перечисление: CreateAssociated enumeration: Create

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);
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 сертификат, указав для rawDataхранилище файлов с подписью PKCS7, 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.

Безопасность

KeyContainerPermission
для разрешения на создание контейнера ключей.for permission to create a key container. Действие безопасности: Demand.Security action: Demand. Связанное перечисление: CreateAssociated enumeration: Create

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);
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 сертификат, указав для rawDataхранилище файлов с подписью PKCS7, 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.

Безопасность

KeyContainerPermission
для разрешения на создание контейнера ключей.for permission to create a key container. Действие безопасности: Demand.Security action: Demand. Связанное перечисление: CreateAssociated enumeration: Create

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);
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 сертификат, указав для fileNameхранилище файлов с подписью PKCS7, 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.

Безопасность

FileIOPermission
для разрешения на чтение файла, описываемого параметром fileName.for permission to read the file described by the fileName parameter. Действие безопасности: Demand.Security action: Demand. Связанное перечисление: ReadAssociated enumeration: Read

KeyContainerPermission
для разрешения на создание контейнера ключей.for permission to create a key container. Действие безопасности: Demand.Security action: Demand. Связанное перечисление: CreateAssociated enumeration: Create

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);
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 сертификат, указав для fileNameхранилище файлов с подписью PKCS7, 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.

Безопасность

FileIOPermission
для разрешения на чтение файла, описываемого параметром fileName.for permission to read the file described by the fileName parameter. Действие безопасности: Demand.Security action: Demand. Связанное перечисление: ReadAssociated enumeration: Read

KeyContainerPermission
для разрешения на создание контейнера ключей.for permission to create a key container. Действие безопасности: Demand.Security action: Demand. Связанное перечисление: CreateAssociated enumeration: Create

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);
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 сертификат, указав для fileNameхранилище файлов с подписью PKCS7, 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.

Безопасность

FileIOPermission
для разрешения на чтение файла, описываемого параметром fileName.for permission to read the file described by the fileName parameter. Действие безопасности: Demand.Security action: Demand. Связанное перечисление: ReadAssociated enumeration: Read

KeyContainerPermission
для разрешения на создание контейнера ключей.for permission to create a key container. Действие безопасности: Demand.Security action: Demand. Связанное перечисление: CreateAssociated enumeration: Create

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);
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 сертификат, указав для rawDataхранилище файлов с подписью PKCS7, 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.

Безопасность

SecurityPermission
для возможности вызова неуправляемого кода.for the ability to call unmanaged code. Действие безопасности: Demand.Security action: Demand. Связанное перечисление: UnmanagedCodeAssociated enumeration: UnmanagedCode

KeyContainerPermission
для разрешения на создание контейнера ключей.for permission to create a key container. Действие безопасности: Demand.Security action: Demand. Связанное перечисление: CreateAssociated enumeration: Create

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 сертификат, указав для fileNameхранилище файлов с подписью PKCS7, 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.

Безопасность

FileIOPermission
для разрешения на чтение файла, описываемого параметром fileName.for permission to read the file described by the fileName parameter. Действие безопасности: Demand.Security action: Demand. Связанное перечисление: ReadAssociated enumeration: Read

KeyContainerPermission
для разрешения на создание контейнера ключей.for permission to create a key container. Действие безопасности: Demand.Security action: Demand. Связанное перечисление: CreateAssociated enumeration: Create

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.

Значение параметра certnull.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);
[System.Security.SecurityCritical]
public X509Certificate (IntPtr handle);
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.

Безопасность

SecurityCriticalAttribute
требуется полное доверие для немедленного вызывающего объекта.requires full trust for the immediate caller. Этот класс не может использоваться частично доверенным или прозрачным кодом.This class cannot be used by partially trusted or transparent code.

InheritanceDemand
для возможности наследников выполнять неуправляемый код.for the ability of inheritors to execute unmanaged code. Связанное перечисление: UnmanagedCodeAssociated enumeration: UnmanagedCode

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 сертификат, указав для dataхранилище файлов с подписью PKCS7, 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.

Безопасность

KeyContainerPermission
для разрешения на создание контейнера ключей.for permission to create a key container. Действие безопасности: Demand.Security action: Demand. Связанное перечисление: CreateAssociated enumeration: Create

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);
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 сертификат, указав для rawDataхранилище файлов с подписью PKCS7, 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.

Безопасность

SecurityPermission
для возможности вызова неуправляемого кода.for the ability to call unmanaged code. Действие безопасности: Demand.Security action: Demand. Связанное перечисление: UnmanagedCodeAssociated enumeration: UnmanagedCode

KeyContainerPermission
для разрешения на создание контейнера ключей.for permission to create a key container. Действие безопасности: Demand.Security action: Demand. Связанное перечисление: CreateAssociated enumeration: Create

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