X509Certificate2.CreateFromPem 方法

定義

命名空間:

System.Security.Cryptography.X509Certificates

組件:

System.Security.Cryptography.dll

多載

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

CreateFromPem(ReadOnlySpan<Char>)

來源:

X509Certificate2.cs

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

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

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

來源:

X509Certificate2.cs

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

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

[<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 PRIVATE KEY” 和 “PRIVATE 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>) 來指定密碼。