X509Certificate2.Import Yöntem

Tanım

Ad Alanı:

System.Security.Cryptography.X509Certificates

Bütünleştirilmiş Kod:

System.Security.Cryptography.dll

Bir X509Certificate2 nesneyi sağlanan sertifika bilgileriyle doldurur.

Aşırı Yüklemeler

Import(Byte[])	Geçersiz. Bir X509Certificate2 nesneyi bayt dizisinden alınan verilerle doldurur.
Import(String)	Geçersiz. Bir X509Certificate2 nesneyi sertifika dosyasındaki bilgilerle doldurur.
Import(Byte[], SecureString, X509KeyStorageFlags)	Geçersiz. Bir X509Certificate2 bayt dizisinden, paroladan ve anahtar depolama bayrağından verileri kullanarak bir nesneyi doldurur.
Import(Byte[], String, X509KeyStorageFlags)	Geçersiz. Bir X509Certificate2 nesneyi bayt dizisinden, paroladan ve özel anahtarın nasıl içeri aktarılacağını belirlemek için bayraklardan veri kullanarak doldurur.
Import(String, SecureString, X509KeyStorageFlags)	Geçersiz. Bir X509Certificate2 nesneyi sertifika dosyasından, paroladan ve anahtar depolama bayrağından alınan bilgilerle doldurur.
Import(String, String, X509KeyStorageFlags)	Geçersiz. Bir X509Certificate2 nesneyi bir sertifika dosyasından, paroladan ve X509KeyStorageFlags değerden bilgilerle doldurur.

Import(Byte[])

Kaynak:

X509Certificate2.cs

Dikkat

X509Certificate and X509Certificate2 are immutable. Use the appropriate constructor to create a new certificate.

Bir X509Certificate2 nesneyi bayt dizisinden alınan verilerle doldurur.

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

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

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

Public Overrides Sub Import (rawData As Byte())

Parametreler

rawData

Byte[]

X.509 sertifikasından veri içeren bayt dizisi.

Öznitelikler

ObsoleteAttribute

Açıklamalar

Bu yöntem, X.509 sertifikasının ham bayt dizisini almak ve nesneyi ilişkili değerleriyle doldurmak X509Certificate2 için kullanılabilir.

Bu yöntem yalnızca bir bayt dizisi kabul ettiğinden, yalnızca Base64 ile kodlanmış veya DER ile kodlanmış X.509 sertifikası veya PFX/PKCS12 sertifikası gibi parola gerektirmeyen sertifika türleri için kullanılabilir. PFX/PKCS12 sertifikasının birden fazla sertifika içerebileceğini unutmayın. Bu durumda, özel anahtarla ilişkilendirilmiş ilk sertifika kullanılır veya özel anahtar bulunmazsa ilk sertifika kullanılır.

Import(String)

Kaynak:

X509Certificate2.cs

Dikkat

X509Certificate and X509Certificate2 are immutable. Use the appropriate constructor to create a new certificate.

Bir X509Certificate2 nesneyi sertifika dosyasındaki bilgilerle doldurur.

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

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

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

Public Overrides Sub Import (fileName As String)

Parametreler

fileName

String

Sertifikanın adı.

Öznitelikler

ObsoleteAttribute

Açıklamalar

Bu yöntem, X.509 sertifikasını temsil eden ve nesneyi dosyanın içerdiği sertifikayla dolduran X509Certificate2 .cer uzantısına sahip bir dosya gibi bir sertifika dosyası kullanır.

Bu yöntem Base64 kodlamalı veya DER ile kodlanmış X.509 sertifikaları, PFX/PKCS12 sertifikaları ve Authenticode gibi imzalayan sertifikalar gibi çeşitli sertifika türleriyle kullanılabilir. PFX/PKCS12 sertifikasının birden fazla sertifika içerebileceğini unutmayın. Bu durumda, özel anahtarla ilişkilendirilmiş ilk sertifika kullanılır veya özel anahtar bulunmazsa ilk sertifika kullanılır.

Import(Byte[], SecureString, X509KeyStorageFlags)

Kaynak:

X509Certificate2.cs

Dikkat

X509Certificate and X509Certificate2 are immutable. Use the appropriate constructor to create a new certificate.

Önemli

Bu API, CLS uyumlu değildir.

Bir X509Certificate2 bayt dizisinden, paroladan ve anahtar depolama bayrağından verileri kullanarak bir nesneyi doldurur.

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 the appropriate constructor 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 the appropriate constructor 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)

Parametreler

rawData

Byte[]

X.509 sertifikasındaki verileri içeren bayt dizisi.

password

SecureString

X.509 sertifika verilerine erişmek için gereken parola.

keyStorageFlags

X509KeyStorageFlags

Sertifikanın nerede ve nasıl içeri aktarılacağını denetleye sabit listesi değerlerinin bit düzeyinde birleşimi.

Öznitelikler

CLSCompliantAttribute ObsoleteAttribute

Açıklamalar

Base64 ile kodlanmış veya DER ile kodlanmış X.509 sertifikaları ya da PFX/PKCS12 sertifikaları gibi sertifika türleri için bu yöntemi kullanabilirsiniz. PFX/PKCS12 sertifikasının birden fazla sertifika içerebileceğini unutmayın. Bu durumda, özel anahtarla ilişkilendirilmiş ilk sertifika kullanılır veya özel anahtar bulunmazsa ilk sertifika kullanılır.

Önemli

Kaynak kodunuz içinde hiçbir zaman bir parolayı sabit kodlamayın. Sabit kodlanmış parolalar ,Ildasm.exe (IL Disassembler), bir onaltılık düzenleyici kullanılarak veya derlemeyi Notepad.exe gibi bir metin düzenleyicisinde açarak bir derlemeden alınabilir.

Import(Byte[], String, X509KeyStorageFlags)

Kaynak:

X509Certificate2.cs

Dikkat

X509Certificate and X509Certificate2 are immutable. Use the appropriate constructor to create a new certificate.

Bir X509Certificate2 nesneyi bayt dizisinden, paroladan ve özel anahtarın nasıl içeri aktarılacağını belirlemek için bayraklardan veri kullanarak doldurur.

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 the appropriate constructor 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 the appropriate constructor 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)

Parametreler

rawData

Byte[]

X.509 sertifikasından veri içeren bayt dizisi.

password

String

X.509 sertifika verilerine erişmek için gereken parola.

keyStorageFlags

X509KeyStorageFlags

Sertifikanın nerede ve nasıl içeri aktarılacağını denetleye sabit listesi değerlerinin bit düzeyinde birleşimi.

Öznitelikler

ObsoleteAttribute

Örnekler

Aşağıdaki kod örneği, bir sertifika dosyasını bağımsız değişken olarak alan ve çeşitli sertifika özelliklerini konsola yazdıran bir komut satırı yürütülebilir dosyası oluşturur.

#using <System.dll>

using namespace System;
using namespace System::Security::Cryptography;
using namespace System::Security::Permissions;
using namespace System::IO;
using namespace System::Security::Cryptography::X509Certificates;

//Reads a file.
array<Byte>^ ReadFile( String^ fileName )
{
   FileStream^ f = gcnew FileStream( fileName,FileMode::Open,FileAccess::Read );
   int size = (int)f->Length;
   array<Byte>^data = gcnew array<Byte>(size);
   size = f->Read( data, 0, size );
   f->Close();
   return data;
}

[SecurityPermissionAttribute(SecurityAction::LinkDemand, Unrestricted = true)]
int main()
{
   array<String^>^args = Environment::GetCommandLineArgs();

   //Test for correct number of arguments.
   if ( args->Length < 2 )
   {
      Console::WriteLine( "Usage: CertInfo <filename>" );
      return  -1;
   }

   try
   {
      System::Security::Cryptography::X509Certificates::X509Certificate2 ^ x509 =
            gcnew System::Security::Cryptography::X509Certificates::X509Certificate2;

      //Create X509Certificate2 object from .cer file.
      array<Byte>^rawData = ReadFile( args[ 1 ] );

      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.
      X509Store ^ store = gcnew 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." );
   }

}

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
        {
            X509Certificate2 x509 = new X509Certificate2();
            //Create X509Certificate2 object from .cer file.
            byte[] rawData = 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.
            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

Açıklamalar

Bu yöntem, bayt dizisi tarafından temsil edilen sertifika için bir parola kullanarak bir X509Certificate2 nesneyi doldurmak için kullanılabilir. X509KeyStorageFlags değeri, özel anahtarın nerede ve nasıl içeri aktarılacağını denetlemek için kullanılabilir.

Bu yöntem bir bayt dizisi kabul eder ve Base64 ile kodlanmış veya DER ile kodlanmış X.509 sertifikaları veya PFX/PKCS12 sertifikaları gibi sertifika türleri için kullanılabilir. PFX/PKCS12 sertifikasının birden fazla sertifika içerebileceğini unutmayın. Bu durumda, özel anahtarla ilişkilendirilmiş ilk sertifika kullanılır veya özel anahtar bulunmazsa ilk sertifika kullanılır.

Önemli

Kaynak kodunuz içinde hiçbir zaman bir parolayı sabit kodlamayın. Sabit kodlanmış parolalar ,Ildasm.exe (IL Disassembler), bir onaltılık düzenleyici kullanılarak veya derlemeyi Notepad.exe gibi bir metin düzenleyicisinde açarak bir derlemeden alınabilir.

Import(String, SecureString, X509KeyStorageFlags)

Kaynak:

X509Certificate2.cs

Dikkat

X509Certificate and X509Certificate2 are immutable. Use the appropriate constructor to create a new certificate.

Önemli

Bu API, CLS uyumlu değildir.

Bir X509Certificate2 nesneyi sertifika dosyasından, paroladan ve anahtar depolama bayrağından alınan bilgilerle doldurur.

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 the appropriate constructor 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 the appropriate constructor 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)

Parametreler

fileName

String

Sertifika dosyasının adı.

password

SecureString

X.509 sertifika verilerine erişmek için gereken parola.

keyStorageFlags

X509KeyStorageFlags

Sertifikanın nerede ve nasıl içeri aktarılacağını denetleye sabit listesi değerlerinin bit düzeyinde birleşimi.

Öznitelikler

CLSCompliantAttribute ObsoleteAttribute

Açıklamalar

Güvenlik Notu Kaynak kodunuz içinde hiçbir zaman bir parolayı sabit kodlamayın. Sabit kodlanmış parolalar ,Ildasm.exe (IL Disassembler), bir onaltılık düzenleyici kullanılarak veya derlemeyi Notepad.exe gibi bir metin düzenleyicisinde açarak bir derlemeden alınabilir.

Import(String, String, X509KeyStorageFlags)

Kaynak:

X509Certificate2.cs

Dikkat

X509Certificate and X509Certificate2 are immutable. Use the appropriate constructor to create a new certificate.

Bir X509Certificate2 nesneyi bir sertifika dosyasından, paroladan ve X509KeyStorageFlags değerden bilgilerle doldurur.

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

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

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

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

Parametreler

fileName

String

Sertifika dosyasının adı.

password

String

X.509 sertifika verilerine erişmek için gereken parola.

keyStorageFlags

X509KeyStorageFlags

Sertifikanın nerede ve nasıl içeri aktarılacağını denetleye sabit listesi değerlerinin bit düzeyinde birleşimi.

Öznitelikler

ObsoleteAttribute

Açıklamalar

Bu yöntem bir X509Certificate2 nesneyi sertifika dosyasından, paroladan ve X509KeyStorageFlags değerden bilgilerle doldurmak için kullanılabilir.

Önemli

Kaynak kodunuz içinde hiçbir zaman bir parolayı sabit kodlamayın. Sabit kodlanmış parolalar ,Ildasm.exe (IL Disassembler), bir onaltılık düzenleyici kullanılarak veya derlemeyi Notepad.exe gibi bir metin düzenleyicisinde açarak bir derlemeden alınabilir.