X509Certificate2.Import Metode

Definisi

Ruang nama:

System.Security.Cryptography.X509Certificates

Rakitan:

netstandard.dll, System.Security.Cryptography.dll

Mengisi X509Certificate2 objek dengan informasi sertifikat yang disediakan.

Overload

Nama	Deskripsi
Import(Byte[])	Kedaluwarsa. Mengisi X509Certificate2 objek dengan data dari array byte.
Import(String)	Kedaluwarsa. Mengisi X509Certificate2 objek dengan informasi dari file sertifikat.
Import(Byte[], SecureString, X509KeyStorageFlags)	Kedaluwarsa. Mengisi X509Certificate2 objek menggunakan data dari array byte, kata sandi, dan bendera penyimpanan kunci.
Import(Byte[], String, X509KeyStorageFlags)	Kedaluwarsa. Mengisi X509Certificate2 objek menggunakan data dari array byte, kata sandi, dan bendera untuk menentukan cara mengimpor kunci privat.
Import(String, SecureString, X509KeyStorageFlags)	Kedaluwarsa. Mengisi X509Certificate2 objek dengan informasi dari file sertifikat, kata sandi, dan bendera penyimpanan kunci.
Import(String, String, X509KeyStorageFlags)	Kedaluwarsa. Mengisi X509Certificate2 objek dengan informasi dari file sertifikat, kata sandi, dan X509KeyStorageFlags nilai.

Import(Byte[])

Sumber:

X509Certificate2.cs

Perhatian

X509Certificate and X509Certificate2 are immutable. Use X509CertificateLoader to create a new certificate.

Mengisi X509Certificate2 objek dengan data dari array byte.

public:
 override void Import(cli::array <System::Byte> ^ rawData);

[System.Obsolete("X509Certificate and X509Certificate2 are immutable. Use X509CertificateLoader to create a new certificate.", DiagnosticId="SYSLIB0026", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public override void Import(byte[] rawData);

[<System.Obsolete("X509Certificate and X509Certificate2 are immutable. Use X509CertificateLoader to create a new certificate.", DiagnosticId="SYSLIB0026", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
override this.Import : byte[] -> unit

Public Overrides Sub Import (rawData As Byte())

Parameter

rawData

Byte[]

Array byte yang berisi data dari sertifikat X.509.

Atribut

ObsoleteAttribute

Keterangan

Metode ini dapat digunakan untuk mengambil array byte mentah dari sertifikat X.509 dan mengisi X509Certificate2 objek dengan nilai terkait.

Karena metode ini hanya menerima array byte, metode ini hanya dapat digunakan untuk jenis sertifikat yang tidak memerlukan kata sandi, termasuk sertifikat X.509 yang dikodekan PEM atau DER atau sertifikat PFX/PKCS12. Perhatikan bahwa sertifikat PFX/PKCS12 dapat berisi lebih dari satu sertifikat. Dalam hal ini, sertifikat pertama yang terkait dengan kunci privat digunakan atau, jika tidak ada kunci privat yang ditemukan, sertifikat pertama digunakan.

Import(String)

Sumber:

X509Certificate2.cs

Perhatian

X509Certificate and X509Certificate2 are immutable. Use X509CertificateLoader to create a new certificate.

Mengisi X509Certificate2 objek dengan informasi dari file sertifikat.

public:
 override void Import(System::String ^ fileName);

[System.Obsolete("X509Certificate and X509Certificate2 are immutable. Use X509CertificateLoader to create a new certificate.", DiagnosticId="SYSLIB0026", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public override void Import(string fileName);

[<System.Obsolete("X509Certificate and X509Certificate2 are immutable. Use X509CertificateLoader to create a new certificate.", DiagnosticId="SYSLIB0026", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
override this.Import : string -> unit

Public Overrides Sub Import (fileName As String)

Parameter

fileName

String

Nama sertifikat.

Atribut

ObsoleteAttribute

Keterangan

Metode ini menggunakan file sertifikat, seperti file dengan ekstensi .cer, yang mewakili sertifikat X.509 dan mengisi X509Certificate2 objek dengan sertifikat yang dikandung file.

Metode ini dapat digunakan dengan beberapa jenis sertifikat, termasuk sertifikat X.509 yang dikodekan PEM atau dikodekan DER, sertifikat PFX/PKCS12, dan sertifikat penanda tangan seperti Authenticode. Perhatikan bahwa sertifikat PFX/PKCS12 dapat berisi lebih dari satu sertifikat. Dalam hal ini, sertifikat pertama yang terkait dengan kunci privat digunakan atau, jika tidak ada kunci privat yang ditemukan, sertifikat pertama digunakan.

Import(Byte[], SecureString, X509KeyStorageFlags)

Sumber:

X509Certificate2.cs

Perhatian

X509Certificate and X509Certificate2 are immutable. Use X509CertificateLoader to create a new certificate.

Penting

API ini bukan kompatibel CLS.

Mengisi X509Certificate2 objek menggunakan data dari array byte, kata sandi, dan bendera penyimpanan kunci.

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

[System.CLSCompliant(false)]
[System.Obsolete("X509Certificate and X509Certificate2 are immutable. Use X509CertificateLoader to create a new certificate.", DiagnosticId="SYSLIB0026", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public override void Import(byte[] rawData, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[<System.CLSCompliant(false)>]
[<System.Obsolete("X509Certificate and X509Certificate2 are immutable. Use X509CertificateLoader to create a new certificate.", DiagnosticId="SYSLIB0026", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
override this.Import : byte[] * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit

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

Parameter

rawData

Byte[]

Array byte yang berisi data dari sertifikat X.509.

password

SecureString

Kata sandi yang diperlukan untuk mengakses data sertifikat X.509.

keyStorageFlags

X509KeyStorageFlags

Kombinasi bitwise dari nilai enumerasi yang mengontrol di mana dan cara mengimpor sertifikat.

Atribut

CLSCompliantAttribute ObsoleteAttribute

Keterangan

Anda dapat menggunakan metode ini untuk jenis sertifikat seperti sertifikat X.509 yang dikodekan PEM atau dikodekan DER, atau sertifikat PFX/PKCS12. Perhatikan bahwa sertifikat PFX/PKCS12 dapat berisi lebih dari satu sertifikat. Dalam hal ini, sertifikat pertama yang terkait dengan kunci privat digunakan atau, jika tidak ada kunci privat yang ditemukan, sertifikat pertama digunakan.

Important

Jangan pernah mengkodekan kata sandi secara permanen dalam kode sumber Anda. Kata sandi yang dikodekan secara permanen dapat diambil dari rakitan menggunakan Ildasm.exe (IL Disassembler), editor hex, atau hanya dengan membuka rakitan di editor teks seperti Notepad.exe.

Import(Byte[], String, X509KeyStorageFlags)

Sumber:

X509Certificate2.cs

Perhatian

X509Certificate and X509Certificate2 are immutable. Use X509CertificateLoader to create a new certificate.

Mengisi X509Certificate2 objek menggunakan data dari array byte, kata sandi, dan bendera untuk menentukan cara mengimpor kunci privat.

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

[System.Obsolete("X509Certificate and X509Certificate2 are immutable. Use X509CertificateLoader to create a new certificate.", DiagnosticId="SYSLIB0026", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public override void Import(byte[] rawData, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[<System.Obsolete("X509Certificate and X509Certificate2 are immutable. Use X509CertificateLoader to create a new certificate.", DiagnosticId="SYSLIB0026", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
override this.Import : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit

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

Parameter

rawData

Byte[]

Array byte yang berisi data dari sertifikat X.509.

password

String

Kata sandi yang diperlukan untuk mengakses data sertifikat X.509.

keyStorageFlags

X509KeyStorageFlags

Kombinasi bitwise dari nilai enumerasi yang mengontrol di mana dan cara mengimpor sertifikat.

Atribut

ObsoleteAttribute

Contoh

Contoh kode berikut membuat executable baris perintah yang mengambil file sertifikat sebagai argumen dan mencetak berbagai properti sertifikat ke konsol.

using System;
using System.Security.Cryptography;
using System.Security.Permissions;
using System.IO;
using System.Security.Cryptography.X509Certificates;

class CertInfo
{
    //Reads a file.
    internal static byte[] ReadFile (string fileName)
    {
        FileStream f = new FileStream(fileName, FileMode.Open, FileAccess.Read);
        int size = (int)f.Length;
        byte[] data = new byte[size];
        size = f.Read(data, 0, size);
        f.Close();
        return data;
    }
    //Main method begins here.
    static void Main(string[] args)
    {
        //Test for correct number of arguments.
        if (args.Length < 1)
        {
            Console.WriteLine("Usage: CertInfo <filename>");
            return;
        }
        try
        {
            byte[] rawData = ReadFile(args[0]);
            //Create X509Certificate2 object from .cer file.
            X509Certificate2 x509 = new X509Certificate2(rawData);

            //Print to console information contained in the certificate.
            Console.WriteLine("{0}Subject: {1}{0}", Environment.NewLine, x509.Subject);
            Console.WriteLine("{0}Issuer: {1}{0}", Environment.NewLine, x509.Issuer);
            Console.WriteLine("{0}Version: {1}{0}", Environment.NewLine, x509.Version);
            Console.WriteLine("{0}Valid Date: {1}{0}", Environment.NewLine, x509.NotBefore);
            Console.WriteLine("{0}Expiry Date: {1}{0}", Environment.NewLine, x509.NotAfter);
            Console.WriteLine("{0}Thumbprint: {1}{0}", Environment.NewLine, x509.Thumbprint);
            Console.WriteLine("{0}Serial Number: {1}{0}", Environment.NewLine, x509.SerialNumber);
            Console.WriteLine("{0}Friendly Name: {1}{0}", Environment.NewLine, x509.PublicKey.Oid.FriendlyName);
            Console.WriteLine("{0}Public Key Format: {1}{0}", Environment.NewLine, x509.PublicKey.EncodedKeyValue.Format(true));
            Console.WriteLine("{0}Raw Data Length: {1}{0}", Environment.NewLine, x509.RawData.Length);
            Console.WriteLine("{0}Certificate to string: {1}{0}", Environment.NewLine, x509.ToString(true));
            Console.WriteLine("{0}Certificate to XML String: {1}{0}", Environment.NewLine, x509.PublicKey.Key.ToXmlString(false));

            //Add the certificate to a X509Store.
            X509Store store = new X509Store();
            store.Open(OpenFlags.MaxAllowed);
            store.Add(x509);
            store.Close();
        }
        catch (DirectoryNotFoundException)
        {
               Console.WriteLine("Error: The directory specified could not be found.");
        }
        catch (IOException)
        {
            Console.WriteLine("Error: A file in the directory could not be accessed.");
        }
        catch (NullReferenceException)
        {
            Console.WriteLine("File must be a .cer file. Program does not have access to that type of file.");
        }
    }
}

Imports System.Security.Cryptography
Imports System.Security.Permissions
Imports System.IO
Imports System.Security.Cryptography.X509Certificates

Class CertInfo

    'Reads a file.
    Friend Shared Function ReadFile(ByVal fileName As String) As Byte()
        Dim f As New FileStream(fileName, FileMode.Open, FileAccess.Read)
        Dim size As Integer = Fix(f.Length)
        Dim data(size - 1) As Byte
        size = f.Read(data, 0, size)
        f.Close()
        Return data

    End Function 

    <SecurityPermission(SecurityAction.LinkDemand, Unrestricted:=True)> _
    Shared Sub Main(ByVal args() As String)
        'Test for correct number of arguments.
        If args.Length < 1 Then
            Console.WriteLine("Usage: CertInfo <filename>")
            Return
        End If
        Try
            Dim x509 As New X509Certificate2()
            'Create X509Certificate2 object from .cer file.
            Dim rawData As Byte() = ReadFile(args(0))
            
            x509.Import(rawData)

            'Print to console information contained in the certificate.
            Console.WriteLine("{0}Subject: {1}{0}", Environment.NewLine, x509.Subject)
            Console.WriteLine("{0}Issuer: {1}{0}", Environment.NewLine, x509.Issuer)
            Console.WriteLine("{0}Version: {1}{0}", Environment.NewLine, x509.Version)
            Console.WriteLine("{0}Valid Date: {1}{0}", Environment.NewLine, x509.NotBefore)
            Console.WriteLine("{0}Expiry Date: {1}{0}", Environment.NewLine, x509.NotAfter)
            Console.WriteLine("{0}Thumbprint: {1}{0}", Environment.NewLine, x509.Thumbprint)
            Console.WriteLine("{0}Serial Number: {1}{0}", Environment.NewLine, x509.SerialNumber)
            Console.WriteLine("{0}Friendly Name: {1}{0}", Environment.NewLine, x509.PublicKey.Oid.FriendlyName)
            Console.WriteLine("{0}Public Key Format: {1}{0}", Environment.NewLine, x509.PublicKey.EncodedKeyValue.Format(True))
            Console.WriteLine("{0}Raw Data Length: {1}{0}", Environment.NewLine, x509.RawData.Length)
            Console.WriteLine("{0}Certificate to string: {1}{0}", Environment.NewLine, x509.ToString(True))

            Console.WriteLine("{0}Certificate to XML String: {1}{0}", Environment.NewLine, x509.PublicKey.Key.ToXmlString(False))

            'Add the certificate to a X509Store.
            Dim store As New X509Store()
            store.Open(OpenFlags.MaxAllowed)
            store.Add(x509)
            store.Close()

        Catch dnfExcept As DirectoryNotFoundException
            Console.WriteLine("Error: The directory specified could not be found.")
        Catch ioExpcept As IOException
            Console.WriteLine("Error: A file in the directory could not be accessed.")
        Catch nrExcept As NullReferenceException
            Console.WriteLine("File must be a .cer file. Program does not have access to that type of file.")
        End Try

    End Sub
End Class

Keterangan

Metode ini dapat digunakan untuk mengisi X509Certificate2 objek menggunakan kata sandi untuk sertifikat yang diwakili oleh array byte. Nilai X509KeyStorageFlags dapat digunakan untuk mengontrol di mana dan cara mengimpor kunci privat.

Metode ini menerima array byte dan dapat digunakan untuk jenis sertifikat seperti sertifikat X.509 yang dikodekan PEM atau dikodekan DER atau sertifikat PFX/PKCS12. Perhatikan bahwa sertifikat PFX/PKCS12 dapat berisi lebih dari satu sertifikat. Dalam hal ini, sertifikat pertama yang terkait dengan kunci privat digunakan atau, jika tidak ada kunci privat yang ditemukan, sertifikat pertama digunakan.

Important

Jangan pernah mengkodekan kata sandi secara permanen dalam kode sumber Anda. Kata sandi yang dikodekan secara permanen dapat diambil dari rakitan menggunakan Ildasm.exe (IL Disassembler), editor hex, atau hanya dengan membuka rakitan di editor teks seperti Notepad.exe.

Import(String, SecureString, X509KeyStorageFlags)

Sumber:

X509Certificate2.cs

Perhatian

X509Certificate and X509Certificate2 are immutable. Use X509CertificateLoader to create a new certificate.

Penting

API ini bukan kompatibel CLS.

Mengisi X509Certificate2 objek dengan informasi dari file sertifikat, kata sandi, dan bendera penyimpanan kunci.

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

[System.CLSCompliant(false)]
[System.Obsolete("X509Certificate and X509Certificate2 are immutable. Use X509CertificateLoader to create a new certificate.", DiagnosticId="SYSLIB0026", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public override void Import(string fileName, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[<System.CLSCompliant(false)>]
[<System.Obsolete("X509Certificate and X509Certificate2 are immutable. Use X509CertificateLoader to create a new certificate.", DiagnosticId="SYSLIB0026", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
override this.Import : string * System.Security.SecureString * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit

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

Parameter

fileName

String

Nama file sertifikat.

password

SecureString

Kata sandi yang diperlukan untuk mengakses data sertifikat X.509.

keyStorageFlags

X509KeyStorageFlags

Kombinasi bitwise dari nilai enumerasi yang mengontrol di mana dan cara mengimpor sertifikat.

Atribut

CLSCompliantAttribute ObsoleteAttribute

Keterangan

Catatan Keamanan Jangan pernah mengkodekan kata sandi secara permanen dalam kode sumber Anda. Kata sandi yang dikodekan secara permanen dapat diambil dari rakitan menggunakan Ildasm.exe (IL Disassembler), editor hex, atau hanya dengan membuka rakitan di editor teks seperti Notepad.exe.

Import(String, String, X509KeyStorageFlags)

Sumber:

X509Certificate2.cs

Perhatian

X509Certificate and X509Certificate2 are immutable. Use X509CertificateLoader to create a new certificate.

Mengisi X509Certificate2 objek dengan informasi dari file sertifikat, kata sandi, dan X509KeyStorageFlags nilai.

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

[System.Obsolete("X509Certificate and X509Certificate2 are immutable. Use X509CertificateLoader to create a new certificate.", DiagnosticId="SYSLIB0026", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public override void Import(string fileName, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[<System.Obsolete("X509Certificate and X509Certificate2 are immutable. Use X509CertificateLoader to create a new certificate.", DiagnosticId="SYSLIB0026", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
override this.Import : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit

Public Overrides Sub Import (fileName As String, password As String, keyStorageFlags As X509KeyStorageFlags)

Parameter

fileName

String

Nama file sertifikat.

password

String

Kata sandi yang diperlukan untuk mengakses data sertifikat X.509.

keyStorageFlags

X509KeyStorageFlags

Kombinasi bitwise dari nilai enumerasi yang mengontrol di mana dan cara mengimpor sertifikat.

Atribut

ObsoleteAttribute

Keterangan

Metode ini dapat digunakan X509Certificate2 mengisi objek dengan informasi dari file sertifikat, kata sandi, dan X509KeyStorageFlags nilai.

Important

Jangan pernah mengkodekan kata sandi secara permanen dalam kode sumber Anda. Kata sandi yang dikodekan secara permanen dapat diambil dari rakitan menggunakan Ildasm.exe (IL Disassembler), editor hex, atau hanya dengan membuka rakitan di editor teks seperti Notepad.exe.