X509Certificate.Import 方法

定義

命名空間:

System.Security.Cryptography.X509Certificates

組件:

System.Security.Cryptography.dll

填入 X509Certificate 物件。

多載

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

Import(String, String, X509KeyStorageFlags)

來源:

X509Certificate.cs

警告

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

[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);

[<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

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

參數

fileName

String

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

password

String

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

keyStorageFlags

X509KeyStorageFlags

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

屬性

ObsoleteAttribute

例外狀況

ArgumentException

fileName 參數為 null。

PlatformNotSupportedException

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

備註

重要

絕對不要在原始程式碼中硬式編碼密碼。 使用 Ildasm.exe (IL 反組譯程式) 、十六進位編輯器，或在文本編輯器中開啟元件，例如 Notepad.exe，即可從元件擷取硬式編碼密碼。

Import(String, SecureString, X509KeyStorageFlags)

來源:

X509Certificate.cs

警告

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

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

參數

fileName

String

憑證檔的名稱。

password

SecureString

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

keyStorageFlags

X509KeyStorageFlags

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

屬性

CLSCompliantAttribute ObsoleteAttribute

例外狀況

ArgumentException

fileName 參數為 null。

PlatformNotSupportedException

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

備註

重要

絕對不要在原始程式碼內硬式編碼密碼。 使用 Ildasm.exe (IL 反組譯程式) 、十六進位編輯器，或在文本編輯器中開啟元件，例如 Notepad.exe，即可從元件擷取硬式編碼密碼。

Import(Byte[], String, X509KeyStorageFlags)

來源:

X509Certificate.cs

警告

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

[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);

[<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

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

參數

rawData

Byte[]

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

password

String

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

keyStorageFlags

X509KeyStorageFlags

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

屬性

ObsoleteAttribute

例外狀況

ArgumentException

rawData 參數為 null。

-或-

rawData 參數的長度為 0。

PlatformNotSupportedException

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

備註

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

Import(Byte[])

來源:

X509Certificate.cs

警告

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.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.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

Public Overridable Sub Import (rawData As Byte())

參數

rawData

Byte[]

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

屬性

ObsoleteAttribute

例外狀況

ArgumentException

rawData 參數為 null。

-或-

rawData 參數的長度為 0。

PlatformNotSupportedException

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

備註

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

Import(String)

來源:

X509Certificate.cs

警告

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

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

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

Public Overridable Sub Import (fileName As String)

參數

fileName

String

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

屬性

ObsoleteAttribute

例外狀況

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.cs

警告

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

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

例外狀況

ArgumentException

rawData 參數為 null。

-或-

rawData 參數的長度為 0。

PlatformNotSupportedException

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

備註

重要

絕對不要在原始程式碼內硬式編碼密碼。 使用 Ildasm.exe (IL 反組譯程式) 、十六進位編輯器，或在文本編輯器中開啟元件，例如 Notepad.exe，即可從元件擷取硬式編碼密碼。