X509Certificate.Import Метод

Определение

Заполняет объект X509Certificate.Populates an X509Certificate object.

Перегрузки

Import(Byte[])

Заполняет объект X509Certificate данными из массива байтов.Populates the X509Certificate object with data from a byte array.

Import(String)

Заполняет объект X509Certificate сведениями из файла сертификата.Populates the X509Certificate object with information from a certificate file.

Import(Byte[], SecureString, X509KeyStorageFlags)

Заполняет объект X509Certificate с помощью данных из массива данных, пароля и флага хранилища ключа.Populates an X509Certificate object using data from a byte array, a password, and a key storage flag.

Import(Byte[], String, X509KeyStorageFlags)

Заполняет объект X509Certificate с помощью данных из массива байтов, пароля и флагов, чтобы определить способ импорта закрытого ключа.Populates the X509Certificate object using data from a byte array, a password, and flags for determining how the private key is imported.

Import(String, SecureString, X509KeyStorageFlags)

Заполняет объект X509Certificate сведениями из файла сертификата, паролем и флагом хранилища ключа.Populates an X509Certificate object with information from a certificate file, a password, and a key storage flag.

Import(String, String, X509KeyStorageFlags)

Заполняет объект X509Certificate сведениями из файла сертификата, паролем и значением X509KeyStorageFlags.Populates the X509Certificate object with information from a certificate file, a password, and a X509KeyStorageFlags value.

Import(Byte[])

Заполняет объект X509Certificate данными из массива байтов.Populates the X509Certificate object with data from a byte array.

public:
 virtual void Import(cli::array <System::Byte> ^ rawData);
[System.Runtime.InteropServices.ComVisible(false)]
[System.Security.SecurityCritical]
public virtual void Import (byte[] rawData);
abstract member Import : byte[] -> unit
override this.Import : byte[] -> unit
Public Overridable Sub Import (rawData As Byte())

Параметры

rawData
Byte[]

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

Атрибуты

Исключения

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

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

Только в .NET Core: Во всех случаях..NET Core only: In all cases.

Комментарии

Этот метод можно использовать для получения необработанного байтового массива сертификата X. 509 и заполнения объекта X509Certificate связанными с ним значениями.This method can be used to take the raw byte array of an X.509 certificate and populate the X509Certificate object with its associated values.

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

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

InheritanceDemand
Полный уровень доверия для разработчиков производных классов.for full trust for inheritors. Этот член не может наследоваться частично доверенным кодом.This member cannot be inherited by partially trusted code.

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

Import(String)

Заполняет объект X509Certificate сведениями из файла сертификата.Populates the X509Certificate object with information from a certificate file.

public:
 virtual void Import(System::String ^ fileName);
[System.Runtime.InteropServices.ComVisible(false)]
[System.Security.SecurityCritical]
public virtual void Import (string fileName);
abstract member Import : string -> unit
override this.Import : string -> unit
Public Overridable Sub Import (fileName As String)

Параметры

fileName
String

Имя файла сертификата, представленное в виде строки.The name of a certificate file represented as a string.

Атрибуты

Исключения

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

Только в .NET Core: Во всех случаях..NET Core only: In all cases.

Примеры

В следующем примере из файла загружается сертификат 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;
   cert->Import(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;

class X509
{

    static void Main()
    {

        // The path to the certificate.
        string Certificate = "Certificate.cer";

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

        cert.Import(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

        cert.Import(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

Комментарии

Этот метод использует файл сертификата (например, файл с расширением CER), представляющий сертификат X. 509, и заполняет объект X509Certificate сертификатом, который содержит файл.This method uses a certificate file (such as a file with a .cer extension) that represents an X.509 certificate, and populates the X509Certificate object with the certificate that the file contains.

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

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

InheritanceDemand
Полный уровень доверия для разработчиков производных классов.for full trust for inheritors. Этот член не может наследоваться частично доверенным кодом.This member cannot be inherited by partially trusted code.

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

Import(Byte[], SecureString, X509KeyStorageFlags)

Важно!

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

Заполняет объект X509Certificate с помощью данных из массива данных, пароля и флага хранилища ключа.Populates an X509Certificate object using data from a byte array, a password, and a key storage flag.

public:
 virtual void Import(cli::array <System::Byte> ^ rawData, System::Security::SecureString ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public virtual void Import (byte[] rawData, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
abstract member Import : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit
override this.Import : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit
Public Overridable Sub Import (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.

Атрибуты

Исключения

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

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

Только в .NET Core: Во всех случаях..NET Core only: In all cases.

Комментарии

Важно!

Никогда не следует жестко кодировать пароль в исходном коде.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.

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

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

InheritanceDemand
Полный уровень доверия для разработчиков производных классов.for full trust for inheritors. Этот член не может наследоваться частично доверенным кодом.This member cannot be inherited by partially trusted code.

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

Import(Byte[], String, X509KeyStorageFlags)

Заполняет объект X509Certificate с помощью данных из массива байтов, пароля и флагов, чтобы определить способ импорта закрытого ключа.Populates the X509Certificate object using data from a byte array, a password, and flags for determining how the private key is imported.

public:
 virtual void Import(cli::array <System::Byte> ^ rawData, System::String ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);
[System.Runtime.InteropServices.ComVisible(false)]
[System.Security.SecurityCritical]
public virtual void Import (byte[] rawData, string password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
abstract member Import : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit
override this.Import : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit
Public Overridable Sub Import (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.

Атрибуты

Исключения

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

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

Только в .NET Core: Во всех случаях..NET Core only: In all cases.

Комментарии

Этот метод можно использовать для заполнения объекта X509Certificate с помощью пароля для сертификата, представленного массивом байтов.This method can be used to populate an X509Certificate object using a password for the certificate represented by the byte array. Значение X509KeyStorageFlags может использоваться для управления тем, где и как импортируется закрытый ключ.The X509KeyStorageFlags value can be used to control where and how the private key is imported.

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

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

InheritanceDemand
Полный уровень доверия для разработчиков производных классов.for full trust for inheritors. Этот член не может наследоваться частично доверенным кодом.This member cannot be inherited by partially trusted code.

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

Import(String, SecureString, X509KeyStorageFlags)

Важно!

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

Заполняет объект X509Certificate сведениями из файла сертификата, паролем и флагом хранилища ключа.Populates an X509Certificate object with information from a certificate file, a password, and a key storage flag.

public:
 virtual void Import(System::String ^ fileName, System::Security::SecureString ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public virtual void Import (string fileName, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
abstract member Import : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit
override this.Import : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit
Public Overridable Sub Import (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.

Атрибуты

Исключения

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

Только в .NET Core: Во всех случаях..NET Core only: In all cases.

Комментарии

Важно!

Никогда не следует жестко кодировать пароль в исходном коде.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.

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

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

InheritanceDemand
Полный уровень доверия для разработчиков производных классов.for full trust for inheritors. Этот член не может наследоваться частично доверенным кодом.This member cannot be inherited by partially trusted code.

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

Import(String, String, X509KeyStorageFlags)

Заполняет объект X509Certificate сведениями из файла сертификата, паролем и значением X509KeyStorageFlags.Populates the X509Certificate object with information from a certificate file, a password, and a X509KeyStorageFlags value.

public:
 virtual void Import(System::String ^ fileName, System::String ^ password, System::Security::Cryptography::X509Certificates::X509KeyStorageFlags keyStorageFlags);
[System.Runtime.InteropServices.ComVisible(false)]
[System.Security.SecurityCritical]
public virtual void Import (string fileName, string password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);
abstract member Import : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit
override this.Import : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit
Public Overridable Sub Import (fileName As String, password As String, keyStorageFlags As X509KeyStorageFlags)

Параметры

fileName
String

Имя файла сертификата, представленное в виде строки.The name of a certificate file represented as a string.

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.

Атрибуты

Исключения

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

Только в .NET Core: Во всех случаях..NET Core only: In all cases.

Комментарии

Важно!

Никогда не следует жестко кодировать пароль в исходном коде.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.

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

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

InheritanceDemand
Полный уровень доверия для разработчиков производных классов.for full trust for inheritors. Этот член не может наследоваться частично доверенным кодом.This member cannot be inherited by partially trusted code.

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

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