X509Certificate2.CreateFromPem Metoda

Definice

Obor názvů:

System.Security.Cryptography.X509Certificates

Sestavení:

System.Security.Cryptography.X509Certificates.dll

Sestavení:

System.Security.Cryptography.dll

Přetížení

CreateFromPem(ReadOnlySpan<Char>)	Vytvoří nový certifikát X509 z obsahu certifikátu RFC 7468 PEM kódovaného certifikátem.
CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>)	Vytvoří nový certifikát X509 z obsahu certifikátu RFC 7468 PEM kódovaného certifikátem a privátním klíčem.

CreateFromPem(ReadOnlySpan<Char>)

Vytvoří nový certifikát X509 z obsahu certifikátu RFC 7468 PEM kódovaného certifikátem.

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

Parametry

certPem

ReadOnlySpan<Char>

Text certifikátu X509 s kódováním PEM.

Návraty

X509Certificate2

Nový certifikát X509

Atributy

UnsupportedOSPlatformAttribute

Výjimky

CryptographicException

Obsah certPem certifikátu s kódováním PEM neobsahuje nebo je poškozený.

Poznámky

Tím se načte první dobře vytvořený PEM s popiskem CERTIFICATE.

Pro certifikáty kódované PEM s privátním klíčem použijte CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>).

Pro certifikáty s kódováním PEM v souboru použijte X509Certificate2(String).

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

Vytvoří nový certifikát X509 z obsahu certifikátu RFC 7468 PEM kódovaného certifikátem a privátním klíčem.

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

Parametry

certPem

ReadOnlySpan<Char>

Text certifikátu X509 s kódováním PEM.

keyPem

ReadOnlySpan<Char>

Text privátního klíče kódovaného PEM.

Návraty

X509Certificate2

Nový certifikát s privátním klíčem.

Atributy

UnsupportedOSPlatformAttribute

Výjimky

CryptographicException

Obsah certPem certifikátu s kódováním PEM neobsahuje nebo je poškozený.

-nebo-

Obsah nezakódovaného privátního keyPem klíče PEM neobsahuje nebo je poškozený.

-nebo-

Obsah keyPem obsahuje klíč, který neodpovídá veřejnému klíči v certifikátu.

-nebo-

Certifikát používá neznámý algoritmus veřejného klíče.

Poznámky

SubjectPublicKeyInfo z certifikátu určuje, jaké popisky PEM jsou pro privátní klíč přijaty. Pro certifikáty RSA jsou akceptované popisky PEM privátního klíče "RSA PRIVATE KEY" a "PRIVATE KEY". U certifikátů ECDSA jsou akceptované popisky PEM privátního klíče "EC PRIVATE KEY" a "PRIVATE KEY". U certifikátů DSA je přijatý popisek PEM privátního klíče "PRIVATE KEY".

Položky s kódováním PEM, které mají jiný popisek, se ignorují.

Pokud je certifikát s kódováním PEM a privátní klíč ve stejném textu, použijte stejný řetězec pro oba certPem a keyPemnapříklad CreateFromPem(combinedCertAndKey, combinedCertAndKey);. Kombinované certifikáty a klíče kódované PEM nevyžadují konkrétní pořadí. Pro certifikát se načte první certifikát s popiskem CERTIFICATE. Pro privátní klíč se načte první privátní klíč s přijatelným popiskem. Pokročilejší scénáře načítání certifikátů a privátních klíčů můžou využít PemEncoding k vytvoření výčtu hodnot kódování PEM a použití jakéhokoli vlastního chování při načítání.

Pro klíče s kódováním PEM chráněné heslem můžete CreateFromEncryptedPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>, ReadOnlySpan<Char>) zadat heslo.