X509Certificate.Export 方法

參考

定義

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

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

組件:: System.Security.Cryptography.dll

組件:: mscorlib.dll

組件:: netstandard.dll

重要

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

將目前的 X509Certificate 物件匯出至位元組陣列。

多載

Export(X509ContentType)	以其中一個 X509Certificate 值所描述的格式，將目前的 X509ContentType 物件匯出至位元組陣列。
Export(X509ContentType, SecureString)	使用指定的格式和密碼，將目前的 X509Certificate 物件匯出至位元組陣列。
Export(X509ContentType, String)	以其中一個 X509Certificate 值所描述的格式，並使用指定的密碼，將目前的 X509ContentType 物件匯出至位元組陣列。

Export(X509ContentType)

以其中一個 X509Certificate 值所描述的格式，將目前的 X509ContentType 物件匯出至位元組陣列。

public:
 virtual cli::array <System::Byte> ^ Export(System::Security::Cryptography::X509Certificates::X509ContentType contentType);

public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType);

[System.Runtime.InteropServices.ComVisible(false)]
public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType);

abstract member Export : System.Security.Cryptography.X509Certificates.X509ContentType -> byte[]
override this.Export : System.Security.Cryptography.X509Certificates.X509ContentType -> byte[]

[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member Export : System.Security.Cryptography.X509Certificates.X509ContentType -> byte[]
override this.Export : System.Security.Cryptography.X509Certificates.X509ContentType -> byte[]

Public Overridable Function Export (contentType As X509ContentType) As Byte()

參數

contentType: X509ContentType

其中一個 X509ContentType 值，其描述如何格式化輸出資料。

傳回

Byte[]

位元組的陣列，表示目前的 X509Certificate 物件。

屬性: ComVisibleAttribute

例外狀況

CryptographicException

將 Cert、SerializedCert 或 Pkcs12 以外的值傳遞至 contentType 參數。

-或- 無法匯出憑證。

範例

下列範例會將 X.509 憑證檔案 X509Certificate 載入物件、將憑證匯出為位元組陣列，然後將位元組陣列匯入另一個 X509Certificate 物件。

using namespace System;
using namespace System::Security::Cryptography::X509Certificates;
int main()
{
   
   // The path to the certificate.
   String^ Certificate = L"test.pfx";
   
   // Load the certificate into an X509Certificate object.
   X509Certificate^ cert = gcnew X509Certificate( Certificate );
   array<Byte>^certData = cert->Export( X509ContentType::Cert );
   X509Certificate^ newCert = gcnew X509Certificate( certData );
   
   // Get the value.
   String^ resultsTrue = newCert->ToString( true );
   
   // Display the value to the console.
   Console::WriteLine( resultsTrue );
   
   // Get the value.
   String^ resultsFalse = newCert->ToString( false );
   
   // Display the value to the console.
   Console::WriteLine( resultsFalse );
}

using System;
using System.Security.Cryptography.X509Certificates;

public class X509
{

    public static void Main()
    {

        // The path to the certificate.
        string Certificate = "test.pfx";

        // Load the certificate into an X509Certificate object.
        X509Certificate cert = new X509Certificate(Certificate);

        byte[] certData = cert.Export(X509ContentType.Cert);

        X509Certificate newCert = new X509Certificate(certData);

        // Get the value.
        string resultsTrue = newCert.ToString(true);

        // Display the value to the console.
        Console.WriteLine(resultsTrue);

        // Get the value.
        string resultsFalse = newCert.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 = "test.pfx"

        ' Load the certificate into an X509Certificate object.
        Dim cert As New X509Certificate(Certificate)


        Dim certData As Byte() = cert.Export(X509ContentType.Cert)

        Dim newCert As New X509Certificate(certData)

        ' Get the value.
        Dim resultsTrue As String = newCert.ToString(True)

        ' Display the value to the console.
        Console.WriteLine(resultsTrue)

        ' Get the value.
        Dim resultsFalse As String = newCert.ToString(False)

        ' Display the value to the console.
        Console.WriteLine(resultsFalse)

    End Sub
End Module

備註

參數 contentType 只接受下列列舉值 X509ContentType ： Cert 、 SerializedCert 和 Pkcs12 。傳遞任何其他值會導致 CryptographicException 擲回。

適用於

Export(X509ContentType, SecureString)

重要

此 API 不符合 CLS 規範。

使用指定的格式和密碼，將目前的 X509Certificate 物件匯出至位元組陣列。

public:
 virtual cli::array <System::Byte> ^ Export(System::Security::Cryptography::X509Certificates::X509ContentType contentType, System::Security::SecureString ^ password);

[System.CLSCompliant(false)]
public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType, System.Security.SecureString? password);

[System.CLSCompliant(false)]
public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType, System.Security.SecureString password);

public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType, System.Security.SecureString password);

[<System.CLSCompliant(false)>]
abstract member Export : System.Security.Cryptography.X509Certificates.X509ContentType * System.Security.SecureString -> byte[]
override this.Export : System.Security.Cryptography.X509Certificates.X509ContentType * System.Security.SecureString -> byte[]

abstract member Export : System.Security.Cryptography.X509Certificates.X509ContentType * System.Security.SecureString -> byte[]
override this.Export : System.Security.Cryptography.X509Certificates.X509ContentType * System.Security.SecureString -> byte[]

Public Overridable Function Export (contentType As X509ContentType, password As SecureString) As Byte()

參數

contentType: X509ContentType

其中一個 X509ContentType 值，其描述如何格式化輸出資料。

password: SecureString

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

傳回

Byte[]

位元組的陣列，表示目前的 X509Certificate 物件。

屬性: CLSCompliantAttribute

例外狀況

CryptographicException

將 Cert、SerializedCert 或 Pkcs12 以外的值傳遞至 contentType 參數。

-或- 無法匯出憑證。

備註

參數 contentType 只接受下列列舉值 X509ContentType ： Cert 、 SerializedCert 和 Pkcs12 。傳遞任何其他值會導致 CryptographicException 擲回。

重要

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

適用於

Export(X509ContentType, String)

以其中一個 X509Certificate 值所描述的格式，並使用指定的密碼，將目前的 X509ContentType 物件匯出至位元組陣列。

public:
 virtual cli::array <System::Byte> ^ Export(System::Security::Cryptography::X509Certificates::X509ContentType contentType, System::String ^ password);

public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType, string? password);

public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType, string password);

[System.Runtime.InteropServices.ComVisible(false)]
public virtual byte[] Export (System.Security.Cryptography.X509Certificates.X509ContentType contentType, string password);

abstract member Export : System.Security.Cryptography.X509Certificates.X509ContentType * string -> byte[]
override this.Export : System.Security.Cryptography.X509Certificates.X509ContentType * string -> byte[]

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

Public Overridable Function Export (contentType As X509ContentType, password As String) As Byte()

參數

contentType: X509ContentType

其中一個 X509ContentType 值，其描述如何格式化輸出資料。

password: String

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

傳回

Byte[]

位元組的陣列，表示目前的 X509Certificate 物件。

屬性: ComVisibleAttribute

例外狀況

CryptographicException

將 Cert、SerializedCert 或 Pkcs12 以外的值傳遞至 contentType 參數。

-或- 無法匯出憑證。

備註

參數 contentType 只接受下列列舉值 X509ContentType ： Cert 、 SerializedCert 和 Pkcs12 。傳遞任何其他值會導致 CryptographicException 擲回。

重要

適用於

X509Certificate.Export 方法

定義

多載

Export(X509ContentType)

參數

傳回

例外狀況

範例

備註

適用於

Export(X509ContentType, SecureString)

參數

傳回

例外狀況

備註

適用於

Export(X509ContentType, String)

參數

傳回

例外狀況

備註

適用於

其他資源