X509Certificate.Import 方法

參考

定義

命名空間:: System.Security.Cryptography.X509Certificates

組件:: System.Security.Cryptography.X509Certificates.dll

組件:: System.Security.Cryptography.dll

組件:: mscorlib.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

填入 X509Certificate 物件。

多載

Import(Byte[])	已過時。用位元組陣列的資料填入 X509Certificate 物件。
Import(String)	已過時。用憑證檔的資訊填入 X509Certificate 物件。
Import(Byte[], SecureString, X509KeyStorageFlags)	已過時。使用位元組陣列的資料、密碼和金鑰儲存旗標，填入 X509Certificate 物件。
Import(Byte[], String, X509KeyStorageFlags)	已過時。用位元組陣列的資料、密碼和用於判斷如何匯入私密金鑰的旗標，填入 X509Certificate 物件。
Import(String, SecureString, X509KeyStorageFlags)	已過時。用憑證檔的資訊、密碼和金鑰儲存旗標，填入 X509Certificate 物件。
Import(String, String, X509KeyStorageFlags)	已過時。用憑證檔案的資訊、密碼和 X509Certificate 值，填入 X509KeyStorageFlags 物件。

Import(Byte[])

警告

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

用位元組陣列的資料填入 X509Certificate 物件。

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

public virtual 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}")]
public virtual void Import (byte[] rawData);

[System.Runtime.InteropServices.ComVisible(false)]
public virtual void Import (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

[<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}")>]
abstract member Import : byte[] -> unit
override this.Import : byte[] -> unit

[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member Import : byte[] -> unit
override this.Import : byte[] -> unit

[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.Security.SecurityCritical>]
abstract member Import : byte[] -> unit
override this.Import : byte[] -> unit

Public Overridable Sub Import (rawData As Byte())

參數

rawData: Byte[]

位元組陣列，包含來自 X.509 憑證的資料。

屬性: ObsoleteAttribute ComVisibleAttribute SecurityCriticalAttribute

例外狀況

ArgumentException

rawData 參數為 null。

-或- rawData 參數的長度為 0。

PlatformNotSupportedException

僅限 .NET Core 與 .NET 5+：在所有情況下。

備註

這個方法可以用來取得 X.509 憑證的原始位元組陣列，並填 X509Certificate 入物件及其相關聯的值。

適用於

Import(String)

警告

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

用憑證檔的資訊填入 X509Certificate 物件。

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

public virtual 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}")]
public virtual void Import (string fileName);

[System.Runtime.InteropServices.ComVisible(false)]
public virtual void Import (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

[<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}")>]
abstract member Import : string -> unit
override this.Import : string -> unit

[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member Import : string -> unit
override this.Import : string -> unit

[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.Security.SecurityCritical>]
abstract member Import : string -> unit
override this.Import : string -> unit

Public Overridable Sub Import (fileName As String)

參數

fileName: String

以字串表示的憑證檔名稱。

屬性: ObsoleteAttribute ComVisibleAttribute SecurityCriticalAttribute

例外狀況

ArgumentException

fileName 參數為 null。

PlatformNotSupportedException

僅限 .NET Core 與 .NET 5+：在所有情況下。

範例

下列範例會從檔案載入 X.509 憑證、呼叫 ToString 方法，並將結果顯示至主控台。

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 入物件。

適用於

Import(Byte[], SecureString, X509KeyStorageFlags)

警告

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

重要

此 API 不符合 CLS 規範。

使用位元組陣列的資料、密碼和金鑰儲存旗標，填入 X509Certificate 物件。

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

[System.CLSCompliant(false)]
public virtual 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}")]
public virtual void Import (byte[] rawData, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[System.CLSCompliant(false)]
public virtual void Import (byte[] rawData, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

public virtual void Import (byte[] rawData, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[System.Security.SecurityCritical]
public virtual void Import (byte[] rawData, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[<System.CLSCompliant(false)>]
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

[<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}")>]
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

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

[<System.Security.SecurityCritical>]
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 憑證的資料。

password: SecureString

存取 X.509 憑證資料所需的密碼。

keyStorageFlags: X509KeyStorageFlags

列舉值的位元組合，會控制匯入憑證的位置和方式。

屬性: CLSCompliantAttribute ObsoleteAttribute SecurityCriticalAttribute

例外狀況

ArgumentException

rawData 參數為 null。

-或- rawData 參數的長度為 0。

PlatformNotSupportedException

僅限 .NET Core 與 .NET 5+：在所有情況下。

備註

重要

請勿在原始程式碼中硬式編碼密碼。硬式編碼的密碼可以使用 Ildasm.exe (IL 反組譯程式) 、十六進位編輯器，或在文字編輯器中開啟元件，例如 Notepad.exe，從元件擷取。

適用於

Import(Byte[], String, X509KeyStorageFlags)

警告

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

用位元組陣列的資料、密碼和用於判斷如何匯入私密金鑰的旗標，填入 X509Certificate 物件。

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

public virtual 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}")]
public virtual void Import (byte[] rawData, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

public virtual void Import (byte[] rawData, string password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[System.Runtime.InteropServices.ComVisible(false)]
public virtual void Import (byte[] rawData, 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

[<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}")>]
abstract member Import : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit
override this.Import : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit

[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member Import : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit
override this.Import : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit

[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.Security.SecurityCritical>]
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 憑證的資料。

password: String

存取 X.509 憑證資料所需的密碼。

keyStorageFlags: X509KeyStorageFlags

列舉值的位元組合，會控制匯入憑證的位置和方式。

屬性: ObsoleteAttribute ComVisibleAttribute SecurityCriticalAttribute

例外狀況

ArgumentException

rawData 參數為 null。

-或- rawData 參數的長度為 0。

PlatformNotSupportedException

僅限 .NET Core 與 .NET 5+：在所有情況下。

備註

這個方法可用來使用位元組陣列所代表憑證的密碼來填 X509Certificate 入物件。值 X509KeyStorageFlags 可用來控制匯入私密金鑰的位置和方式。

適用於

Import(String, SecureString, X509KeyStorageFlags)

警告

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

重要

此 API 不符合 CLS 規範。

用憑證檔的資訊、密碼和金鑰儲存旗標，填入 X509Certificate 物件。

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

[System.CLSCompliant(false)]
public virtual 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}")]
public virtual void Import (string fileName, System.Security.SecureString? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[System.CLSCompliant(false)]
public virtual void Import (string fileName, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

public virtual void Import (string fileName, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[System.Security.SecurityCritical]
public virtual void Import (string fileName, System.Security.SecureString password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[<System.CLSCompliant(false)>]
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

[<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}")>]
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

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

[<System.Security.SecurityCritical>]
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

憑證檔的名稱。

password: SecureString

存取 X.509 憑證資料所需的密碼。

keyStorageFlags: X509KeyStorageFlags

列舉值的位元組合，會控制匯入憑證的位置和方式。

屬性: CLSCompliantAttribute ObsoleteAttribute SecurityCriticalAttribute

例外狀況

ArgumentException

fileName 參數為 null。

PlatformNotSupportedException

僅限 .NET Core 與 .NET 5+：在所有情況下。

備註

重要

適用於

Import(String, String, X509KeyStorageFlags)

警告

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

用憑證檔案的資訊、密碼和 X509Certificate 值，填入 X509KeyStorageFlags 物件。

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

public virtual 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}")]
public virtual void Import (string fileName, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

public virtual void Import (string fileName, string password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags);

[System.Runtime.InteropServices.ComVisible(false)]
public virtual void Import (string fileName, 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

[<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}")>]
abstract member Import : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit
override this.Import : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit

[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member Import : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit
override this.Import : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags -> unit

[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.Security.SecurityCritical>]
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

以字串表示的憑證檔名稱。

password: String

存取 X.509 憑證資料所需的密碼。

keyStorageFlags: X509KeyStorageFlags

列舉值的位元組合，會控制匯入憑證的位置和方式。

屬性: ObsoleteAttribute ComVisibleAttribute SecurityCriticalAttribute

例外狀況

ArgumentException

fileName 參數為 null。

PlatformNotSupportedException

僅限 .NET Core 與 .NET 5+：在所有情況下。

備註

重要

適用於

X509Certificate.Import 方法

定義

多載

Import(Byte[])

參數

例外狀況

備註

適用於

Import(String)

參數

例外狀況

範例

備註

適用於

Import(Byte[], SecureString, X509KeyStorageFlags)

參數

例外狀況

備註

適用於

Import(Byte[], String, X509KeyStorageFlags)

參數

例外狀況

備註

適用於

Import(String, SecureString, X509KeyStorageFlags)

參數

例外狀況

備註

適用於

Import(String, String, X509KeyStorageFlags)

參數

例外狀況

備註

適用於

其他資源