X509Certificate2.CreateFromPem 方法

定義

命名空間:

System.Security.Cryptography.X509Certificates

組件:

System.Security.Cryptography.X509Certificates.dll

組件:

System.Security.Cryptography.dll

多載

CreateFromPem(ReadOnlySpan<Char>)	從 RFC 7468 PEM 編碼憑證的內容建立新的 X509 憑證。
CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>)	從 RFC 7468 PEM 編碼憑證與私密金鑰的內容建立新的 X509 憑證。

CreateFromPem(ReadOnlySpan<Char>)

從 RFC 7468 PEM 編碼憑證的內容建立新的 X509 憑證。

public:
 static System::Security::Cryptography::X509Certificates::X509Certificate2 ^ CreateFromPem(ReadOnlySpan<char> certPem);

public static System.Security.Cryptography.X509Certificates.X509Certificate2 CreateFromPem (ReadOnlySpan<char> certPem);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static System.Security.Cryptography.X509Certificates.X509Certificate2 CreateFromPem (ReadOnlySpan<char> certPem);

static member CreateFromPem : ReadOnlySpan<char> -> System.Security.Cryptography.X509Certificates.X509Certificate2

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member CreateFromPem : ReadOnlySpan<char> -> System.Security.Cryptography.X509Certificates.X509Certificate2

Public Shared Function CreateFromPem (certPem As ReadOnlySpan(Of Char)) As X509Certificate2

參數

certPem

ReadOnlySpan<Char>

PEM 編碼 X509 憑證的文字。

傳回

X509Certificate2

新的 X509 憑證。

屬性

UnsupportedOSPlatformAttribute

例外狀況

CryptographicException

certPem 的內容並不包含 PEM 編碼的憑證，或其格式不正確。

備註

這會載入使用 CERTIFICATE 標籤找到的第一個格式正確的 PEM。

針對具有私密金鑰的 PEM 編碼憑證，請使用 CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>) 。

針對檔案中的 PEM 編碼憑證，請使用 X509Certificate2(String) 。

CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>)

從 RFC 7468 PEM 編碼憑證與私密金鑰的內容建立新的 X509 憑證。

public:
 static System::Security::Cryptography::X509Certificates::X509Certificate2 ^ CreateFromPem(ReadOnlySpan<char> certPem, ReadOnlySpan<char> keyPem);

public static System.Security.Cryptography.X509Certificates.X509Certificate2 CreateFromPem (ReadOnlySpan<char> certPem, ReadOnlySpan<char> keyPem);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static System.Security.Cryptography.X509Certificates.X509Certificate2 CreateFromPem (ReadOnlySpan<char> certPem, ReadOnlySpan<char> keyPem);

static member CreateFromPem : ReadOnlySpan<char> * ReadOnlySpan<char> -> System.Security.Cryptography.X509Certificates.X509Certificate2

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member CreateFromPem : ReadOnlySpan<char> * ReadOnlySpan<char> -> System.Security.Cryptography.X509Certificates.X509Certificate2

Public Shared Function CreateFromPem (certPem As ReadOnlySpan(Of Char), keyPem As ReadOnlySpan(Of Char)) As X509Certificate2

參數

certPem

ReadOnlySpan<Char>

PEM 編碼 X509 憑證的文字。

keyPem

ReadOnlySpan<Char>

PEM 編碼私密金鑰的文字。

傳回

X509Certificate2

含私密金鑰的新憑證。

屬性

UnsupportedOSPlatformAttribute

例外狀況

CryptographicException

certPem 的內容並不包含 PEM 編碼的憑證，或其格式不正確。

-或-

keyPem 其內容並不包含 PEM 編碼私密金鑰，或其格式不正確。

-或-

keyPem 其內容包含不符合憑證中公開金鑰的金鑰。

-或-

憑證會使用未知的公開金鑰演算法。

備註

憑證中的 SubjectPublicKeyInfo 會決定私密金鑰接受哪些 PEM 標籤。 針對 RSA 憑證，接受的私密金鑰 PEM 標籤為 「RSA PRI加值稅E KEY」 和 「PRI加值稅E KEY」。 針對 ECDSA 憑證，接受的私密金鑰 PEM 標籤為「EC 私密金鑰」和「私密金鑰」。 對於 DSA 憑證，接受的私密金鑰 PEM 標籤為「私密金鑰」。

忽略具有不同標籤的 PEM 編碼專案。

如果 PEM 編碼的憑證和私密金鑰位於相同的文字中，請針對 certPem 和 keyPem 使用相同的字串，例如 。 CreateFromPem(combinedCertAndKey, combinedCertAndKey); 合併的 PEM 編碼憑證和金鑰不需要特定順序。 針對憑證，會載入具有 CERTIFICATE 標籤的第一個憑證。 針對私密金鑰，會載入具有可接受的標籤的第一個私密金鑰。 載入憑證和私密金鑰的更進階案例可以利用 PemEncoding 來列舉 PEM 編碼的值，並套用任何自訂載入行為。

針對受密碼保護的 PEM 編碼金鑰，請使用 CreateFromEncryptedPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>, ReadOnlySpan<Char>) 來指定密碼。