X509Certificate2.Import Metoda

Definice

Obor názvů:

System.Security.Cryptography.X509Certificates

Sestavení:

System.Security.Cryptography.dll

Naplní X509Certificate2 objekt zadanými informacemi o certifikátu.

Přetížení

Import(Byte[])	Zastaralé. Naplní X509Certificate2 objekt daty z pole bajtů.
Import(String)	Zastaralé. Naplní X509Certificate2 objekt informacemi ze souboru certifikátu.
Import(Byte[], SecureString, X509KeyStorageFlags)	Zastaralé. Naplní X509Certificate2 objekt pomocí dat z pole bajtů, hesla a příznaku úložiště klíčů.
Import(Byte[], String, X509KeyStorageFlags)	Zastaralé. Naplní X509Certificate2 objekt pomocí dat z pole bajtů, hesla a příznaků pro určení způsobu importu privátního klíče.
Import(String, SecureString, X509KeyStorageFlags)	Zastaralé. Naplní X509Certificate2 objekt informacemi ze souboru certifikátu, heslem a příznakem úložiště klíčů.
Import(String, String, X509KeyStorageFlags)	Zastaralé. Naplní X509Certificate2 objekt informacemi ze souboru certifikátu, heslem a X509KeyStorageFlags hodnotou.

Import(Byte[])

Zdroj:

X509Certificate2.cs

Upozornění

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

Naplní X509Certificate2 objekt daty z pole bajtů.

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

Parametry

rawData

Byte[]

Pole bajtů obsahující data z certifikátu X.509.

Atributy

ObsoleteAttribute

Poznámky

Tuto metodu lze použít k převzetí nezpracovaného pole bajtů certifikátu X.509 a naplnění objektu X509Certificate2 přidruženými hodnotami.

Vzhledem k tomu, že tato metoda přijímá pouze pole bajtů, může být použita pouze pro typy certifikátů, které nevyžadují heslo, včetně certifikátu X.509 kódování Base64 nebo DER nebo certifikátu PFX/PKCS12. Všimněte si, že certifikát PFX/PKCS12 může obsahovat více než jeden certifikát. V takovém případě se použije první certifikát přidružený k privátnímu klíči, nebo pokud se žádný privátní klíč nenajde, použije se první certifikát.

Import(String)

Zdroj:

X509Certificate2.cs

Upozornění

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

Naplní X509Certificate2 objekt informacemi ze souboru certifikátu.

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)

Parametry

fileName

String

Název certifikátu.

Atributy

ObsoleteAttribute

Poznámky

Tato metoda používá soubor certifikátu, například soubor s příponou .cer, který představuje certifikát X.509 a naplní X509Certificate2 objekt certifikátem, který soubor obsahuje.

Tuto metodu lze použít s několika typy certifikátů, včetně certifikátů X.509 s kódováním Base64 nebo DER, certifikátů PFX/PKCS12 a podpisových certifikátů, jako je například Authenticode. Všimněte si, že certifikát PFX/PKCS12 může obsahovat více než jeden certifikát. V takovém případě se použije první certifikát přidružený k privátnímu klíči, nebo pokud se žádný privátní klíč nenajde, použije se první certifikát.

Import(Byte[], SecureString, X509KeyStorageFlags)

Zdroj:

X509Certificate2.cs

Upozornění

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

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Naplní X509Certificate2 objekt pomocí dat z pole bajtů, hesla a příznaku úložiště klíčů.

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)

Parametry

rawData

Byte[]

Bajtové pole, které obsahuje data z certifikátu X.509.

password

SecureString

Heslo vyžadované pro přístup k datům certifikátu X.509.

keyStorageFlags

X509KeyStorageFlags

Bitová kombinace hodnot výčtu, které řídí, kam a jak importovat certifikát.

Atributy

CLSCompliantAttribute ObsoleteAttribute

Poznámky

Tuto metodu můžete použít pro typy certifikátů, jako jsou certifikáty X.509 s kódováním Base64 nebo DER nebo certifikáty PFX/PKCS12. Všimněte si, že certifikát PFX/PKCS12 může obsahovat více než jeden certifikát. V takovém případě se použije první certifikát přidružený k privátnímu klíči, nebo pokud se žádný privátní klíč nenajde, použije se první certifikát.

Důležité

Nikdy pevně nezakódujte heslo ve zdrojovém kódu. Pevně zakódovaná hesla mohou být načtena ze sestavení pomocí Ildasm.exe (IL Disassembler), šestnáctkového editoru nebo jednoduše otevřením sestavení v textovém editoru, například Notepad.exe.

Import(Byte[], String, X509KeyStorageFlags)

Zdroj:

X509Certificate2.cs

Upozornění

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

Naplní X509Certificate2 objekt pomocí dat z pole bajtů, hesla a příznaků pro určení způsobu importu privátního klíče.

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)

Parametry

rawData

Byte[]

Pole bajtů obsahující data z certifikátu X.509.

password

String

Heslo vyžadované pro přístup k datům certifikátu X.509.

keyStorageFlags

X509KeyStorageFlags

Bitová kombinace hodnot výčtu, které řídí, kam a jak importovat certifikát.

Atributy

ObsoleteAttribute

Příklady

Následující příklad kódu vytvoří spustitelný soubor příkazového řádku, který vezme soubor certifikátu jako argument a vypíše různé vlastnosti certifikátu do konzoly.

#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

Poznámky

Tuto metodu lze použít k naplnění objektu X509Certificate2 pomocí hesla pro certifikát reprezentovaný polem bajtů. Pomocí X509KeyStorageFlags této hodnoty můžete řídit, kam a jak importovat privátní klíč.

Tato metoda přijímá pole bajtů a lze ji použít pro typy certifikátů, jako jsou certifikáty X.509 s kódováním Base64 nebo DER nebo certifikáty PFX/PKCS12. Všimněte si, že certifikát PFX/PKCS12 může obsahovat více než jeden certifikát. V takovém případě se použije první certifikát přidružený k privátnímu klíči, nebo pokud se žádný privátní klíč nenajde, použije se první certifikát.

Důležité

Nikdy pevně nezakódujte heslo ve zdrojovém kódu. Pevně zakódovaná hesla mohou být načtena ze sestavení pomocí Ildasm.exe (IL Disassembler), šestnáctkového editoru nebo jednoduše otevřením sestavení v textovém editoru, například Notepad.exe.

Import(String, SecureString, X509KeyStorageFlags)

Zdroj:

X509Certificate2.cs

Upozornění

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

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Naplní X509Certificate2 objekt informacemi ze souboru certifikátu, heslem a příznakem úložiště klíčů.

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)

Parametry

fileName

String

Název souboru certifikátu.

password

SecureString

Heslo vyžadované pro přístup k datům certifikátu X.509.

keyStorageFlags

X509KeyStorageFlags

Bitová kombinace hodnot výčtu, které řídí, kam a jak importovat certifikát.

Atributy

CLSCompliantAttribute ObsoleteAttribute

Poznámky

Poznámka k zabezpečení Nikdy pevně nezakódujte heslo ve zdrojovém kódu. Pevně zakódovaná hesla mohou být načtena ze sestavení pomocí Ildasm.exe (IL Disassembler), šestnáctkového editoru nebo jednoduše otevřením sestavení v textovém editoru, například Notepad.exe.

Import(String, String, X509KeyStorageFlags)

Zdroj:

X509Certificate2.cs

Upozornění

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

Naplní X509Certificate2 objekt informacemi ze souboru certifikátu, heslem a X509KeyStorageFlags hodnotou.

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)

Parametry

fileName

String

Název souboru certifikátu.

password

String

Heslo vyžadované pro přístup k datům certifikátu X.509.

keyStorageFlags

X509KeyStorageFlags

Bitová kombinace hodnot výčtu, které řídí, kam a jak importovat certifikát.

Atributy

ObsoleteAttribute

Poznámky

Tuto metodu lze použít k naplnění objektu X509Certificate2 informacemi ze souboru certifikátu, hesla a X509KeyStorageFlags hodnoty.

Důležité

Nikdy pevně nezakódujte heslo ve zdrojovém kódu. Pevně zakódovaná hesla mohou být načtena ze sestavení pomocí Ildasm.exe (IL Disassembler), šestnáctkového editoru nebo jednoduše otevřením sestavení v textovém editoru, například Notepad.exe.