X509Certificate2.Import Methode

Definition

Namespace:

System.Security.Cryptography.X509Certificates

Assembly:

System.Security.Cryptography.dll

Füllt ein X509Certificate2-Objekt mit den bereitgestellten Zertifikatsinformationen auf.

Überlädt

Import(Byte[])	Veraltet. Füllt ein X509Certificate2-Objekt mit Daten aus einem Bytearray auf.
Import(String)	Veraltet. Füllt ein X509Certificate2-Objekt mit Informationen aus einer Zertifikatsdatei auf.
Import(Byte[], SecureString, X509KeyStorageFlags)	Veraltet. Füllt ein X509Certificate2-Objekt mithilfe der Daten aus einem Bytearray, eines Kennworts und eines Schlüsselspeicherflags auf.
Import(Byte[], String, X509KeyStorageFlags)	Veraltet. Füllt ein X509Certificate2-Objekt mithilfe der Daten aus einem Bytearray, eines Kennworts und von Flags auf, mit denen bestimmt werden kann, wie der private Schlüssel importiert wird.
Import(String, SecureString, X509KeyStorageFlags)	Veraltet. Füllt ein X509Certificate2-Objekt mit Informationen aus einer Zertifikatsdatei, einem Kennwort und einem Schlüsselspeicherflag auf.
Import(String, String, X509KeyStorageFlags)	Veraltet. Füllt ein X509Certificate2-Objekt mit Informationen aus einer Zertifikatsdatei, einem Kennwort und einem X509KeyStorageFlags-Wert auf.

Import(Byte[])

Quelle:

X509Certificate2.cs

Achtung

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

Füllt ein X509Certificate2-Objekt mit Daten aus einem Bytearray auf.

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())

Parameter

rawData

Byte[]

Ein Bytearray mit Daten aus einem X.509-Zertifikat.

Attribute

ObsoleteAttribute

Hinweise

Diese Methode kann verwendet werden, um ein unformatiertes Bytearray eines X.509-Zertifikats zu nehmen und das Objekt mit den X509Certificate2 zugehörigen Werten aufzufüllen.

Da diese Methode nur ein Bytearray akzeptiert, kann sie nur für Zertifikattypen verwendet werden, die kein Kennwort erfordern, einschließlich eines Base64-codierten oder DER-codierten X.509-Zertifikats oder eines PFX/PKCS12-Zertifikats. Beachten Sie, dass ein PFX/PKCS12-Zertifikat mehrere Zertifikate enthalten kann. In diesem Fall wird das erste Zertifikat verwendet, das einem privaten Schlüssel zugeordnet ist, oder, wenn kein privater Schlüssel gefunden wird, das erste Zertifikat verwendet.

Import(String)

Quelle:

X509Certificate2.cs

Achtung

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

Füllt ein X509Certificate2-Objekt mit Informationen aus einer Zertifikatsdatei auf.

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)

Parameter

fileName

String

Der Name eines Zertifikats.

Attribute

ObsoleteAttribute

Hinweise

Diese Methode verwendet eine Zertifikatdatei, z. B. eine Datei mit der Erweiterung CER, die ein X.509-Zertifikat darstellt und das Objekt mit dem X509Certificate2 Zertifikat auffüllt, das die Datei enthält.

Diese Methode kann mit verschiedenen Zertifikattypen verwendet werden, einschließlich Base64-codierter oder DER-codierter X.509-Zertifikate, PFX/PKCS12-Zertifikaten und Signerzertifikaten wie Authenticode. Beachten Sie, dass ein PFX/PKCS12-Zertifikat mehrere Zertifikate enthalten kann. In diesem Fall wird das erste Zertifikat verwendet, das einem privaten Schlüssel zugeordnet ist, oder, wenn kein privater Schlüssel gefunden wird, das erste Zertifikat verwendet.

Import(Byte[], SecureString, X509KeyStorageFlags)

Quelle:

X509Certificate2.cs

Achtung

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

Wichtig

Diese API ist nicht CLS-kompatibel.

Füllt ein X509Certificate2-Objekt mithilfe der Daten aus einem Bytearray, eines Kennworts und eines Schlüsselspeicherflags auf.

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)

Parameter

rawData

Byte[]

Ein Bytearray, das Daten aus einem X.509-Zertifikat enthält.

password

SecureString

Das für den Zugriff auf die X.509-Zertifikatsdaten erforderliche Kennwort.

keyStorageFlags

X509KeyStorageFlags

Eine bitweise Kombination der Enumerationswerte, die steuern wo und wie das Zertifikat importiert wird.

Attribute

CLSCompliantAttribute ObsoleteAttribute

Hinweise

Sie können diese Methode für Zertifikattypen wie Base64-codierte oder DER-codierte X.509-Zertifikate oder PFX/PKCS12-Zertifikate verwenden. Beachten Sie, dass ein PFX/PKCS12-Zertifikat mehrere Zertifikate enthalten kann. In diesem Fall wird das erste Zertifikat verwendet, das einem privaten Schlüssel zugeordnet ist, oder, wenn kein privater Schlüssel gefunden wird, das erste Zertifikat verwendet.

Wichtig

Coden Sie niemals ein Kennwort in Ihrem Quellcode hart. Hartcodierte Kennwörter können aus einer Assembly mithilfe des Ildasm.exe (IL Disassembler) oder eines Sechskant-Editors oder einfach durch Öffnen der Assembly in einem Text-Editor wie Notepad.exe abgerufen werden.

Import(Byte[], String, X509KeyStorageFlags)

Quelle:

X509Certificate2.cs

Achtung

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

Füllt ein X509Certificate2-Objekt mithilfe der Daten aus einem Bytearray, eines Kennworts und von Flags auf, mit denen bestimmt werden kann, wie der private Schlüssel importiert wird.

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)

Parameter

rawData

Byte[]

Ein Bytearray mit Daten aus einem X.509-Zertifikat.

password

String

Das für den Zugriff auf die X.509-Zertifikatsdaten erforderliche Kennwort.

keyStorageFlags

X509KeyStorageFlags

Eine bitweise Kombination der Enumerationswerte, die steuern wo und wie das Zertifikat importiert wird.

Attribute

ObsoleteAttribute

Beispiele

Im folgenden Codebeispiel wird eine ausführbare Befehlszeile erstellt, die eine Zertifikatdatei als Argument akzeptiert und verschiedene Zertifikateigenschaften in der Konsole ausgibt.

#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

Hinweise

Diese Methode kann verwendet werden, um ein X509Certificate2 Objekt mithilfe eines Kennworts für das durch das Bytearray dargestellte Zertifikat aufzufüllen. Der X509KeyStorageFlags Wert kann verwendet werden, um zu steuern, wo und wie der private Schlüssel importiert werden soll.

Diese Methode akzeptiert ein Bytearray und kann für Zertifikattypen wie Base64-codierte oder DER-codierte X.509-Zertifikate oder PFX/PKCS12-Zertifikate verwendet werden. Beachten Sie, dass ein PFX/PKCS12-Zertifikat mehrere Zertifikate enthalten kann. In diesem Fall wird das erste Zertifikat verwendet, das einem privaten Schlüssel zugeordnet ist, oder, wenn kein privater Schlüssel gefunden wird, das erste Zertifikat verwendet.

Wichtig

Coden Sie niemals ein Kennwort in Ihrem Quellcode hart. Hartcodierte Kennwörter können aus einer Assembly mithilfe des Ildasm.exe (IL Disassembler) oder eines Sechskant-Editors oder einfach durch Öffnen der Assembly in einem Text-Editor wie Notepad.exe abgerufen werden.

Import(String, SecureString, X509KeyStorageFlags)

Quelle:

X509Certificate2.cs

Achtung

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

Wichtig

Diese API ist nicht CLS-kompatibel.

Füllt ein X509Certificate2-Objekt mit Informationen aus einer Zertifikatsdatei, einem Kennwort und einem Schlüsselspeicherflag auf.

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)

Parameter

fileName

String

Der Name einer Zertifikatsdatei.

password

SecureString

Das für den Zugriff auf die X.509-Zertifikatsdaten erforderliche Kennwort.

keyStorageFlags

X509KeyStorageFlags

Eine bitweise Kombination der Enumerationswerte, die steuern wo und wie das Zertifikat importiert wird.

Attribute

CLSCompliantAttribute ObsoleteAttribute

Hinweise

Sicherheitshinweis Coden Sie niemals ein Kennwort in Ihrem Quellcode hart. Hartcodierte Kennwörter können aus einer Assembly mithilfe des Ildasm.exe (IL Disassembler) oder eines Sechskant-Editors oder einfach durch Öffnen der Assembly in einem Text-Editor wie Notepad.exe abgerufen werden.

Import(String, String, X509KeyStorageFlags)

Quelle:

X509Certificate2.cs

Achtung

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

Füllt ein X509Certificate2-Objekt mit Informationen aus einer Zertifikatsdatei, einem Kennwort und einem X509KeyStorageFlags-Wert auf.

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)

Parameter

fileName

String

Der Name einer Zertifikatsdatei.

password

String

Das für den Zugriff auf die X.509-Zertifikatsdaten erforderliche Kennwort.

keyStorageFlags

X509KeyStorageFlags

Eine bitweise Kombination der Enumerationswerte, die steuern wo und wie das Zertifikat importiert wird.

Attribute

ObsoleteAttribute

Hinweise

Diese Methode kann verwendet werden, um ein X509Certificate2 Objekt mit Informationen aus einer Zertifikatdatei, einem Kennwort und einem Wert aufzufüllen X509KeyStorageFlags .

Wichtig

Coden Sie niemals ein Kennwort in Ihrem Quellcode hart. Hartcodierte Kennwörter können aus einer Assembly mithilfe des Ildasm.exe (IL Disassembler) oder eines Sechskant-Editors oder einfach durch Öffnen der Assembly in einem Text-Editor wie Notepad.exe abgerufen werden.