X509Certificate2.CreateFromPem Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| CreateFromPem(ReadOnlySpan<Char>) |
Erstellt ein neues X509-Zertifikat aus dem Inhalt eines RFC 7468 PEM-codierten Zertifikats. |
| CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>) |
Erstellt ein neues X509-Zertifikat aus dem Inhalt eines RFC 7468 PEM-codierten Zertifikats und einem privaten Schlüssel. |
CreateFromPem(ReadOnlySpan<Char>)
Erstellt ein neues X509-Zertifikat aus dem Inhalt eines RFC 7468 PEM-codierten Zertifikats.
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.X509Certificate2Public Shared Function CreateFromPem (certPem As ReadOnlySpan(Of Char)) As X509Certificate2Parameter
- certPem
- ReadOnlySpan<Char>
Der Text des PEM-codierten X509-Zertifikats.
Gibt zurück
Ein neues X509-Zertifikat.
- Attribute
Ausnahmen
certPem enthält kein PEM-codiertes Zertifikat, oder es ist falsch formatiert.
Hinweise
Dadurch wird das erste gut gebildete PEM mit einer ZERTIFIKATbezeichnung geladen.
Verwenden Sie CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>)für PEM-codierte Zertifikate mit einem privaten Schlüssel.
Verwenden Sie X509Certificate2(String)für PEM-codierte Zertifikate in einer Datei .
Gilt für
CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>)
Erstellt ein neues X509-Zertifikat aus dem Inhalt eines RFC 7468 PEM-codierten Zertifikats und einem privaten Schlüssel.
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.X509Certificate2Public Shared Function CreateFromPem (certPem As ReadOnlySpan(Of Char), keyPem As ReadOnlySpan(Of Char)) As X509Certificate2Parameter
- certPem
- ReadOnlySpan<Char>
Der Text des PEM-codierten X509-Zertifikats.
- keyPem
- ReadOnlySpan<Char>
Der Text des PEM-codierten privaten Schlüssels.
Gibt zurück
Ein neues Zertifikat mit dem privaten Schlüssel.
- Attribute
Ausnahmen
certPem enthält kein PEM-codiertes Zertifikat, oder es ist falsch formatiert.
- oder -
keyPem enthält keinen PEM-codierten privaten Schlüssel, oder er ist falsch formatiert.
- oder -
keyPem enthält einen Schlüssel, der nicht mit dem öffentlichen Schlüssel im Zertifikat identisch ist.
- oder -
Das Zertifikat verwendet einen unbekannten öffentlichen Schlüsselalgorithmus.
Hinweise
Die SubjectPublicKeyInfo aus dem Zertifikat bestimmt, welche PEM-Bezeichnungen für den privaten Schlüssel akzeptiert werden. Bei RSA-Zertifikaten sind akzeptierte private Schlüssel-PEM-Bezeichnungen "RSA PRIVATE KEY" und "PRIVATE KEY". Bei ECDSA-Zertifikaten sind akzeptierte private Schlüssel-PEM-Bezeichnungen "EC PRIVATE KEY" und "PRIVATE KEY". Bei DSA-Zertifikaten ist die akzeptierte private Schlüssel-PEM-Bezeichnung "PRIVATE KEY".
PEM-codierte Elemente, die über eine andere Bezeichnung verfügen, werden ignoriert.
Wenn sich das PEM-codierte Zertifikat und der private Schlüssel im gleichen Text befinden, verwenden Sie die gleiche Zeichenfolge für beide certPem und keyPembeispielsweise CreateFromPem(combinedCertAndKey, combinedCertAndKey);. Kombinierte PEM-codierte Zertifikate und Schlüssel erfordern keine bestimmte Reihenfolge. Für das Zertifikat wird das erste Zertifikat mit einer ZERTIFIKATbezeichnung geladen. Für den privaten Schlüssel wird der erste private Schlüssel mit einer zulässigen Bezeichnung geladen. Weitere erweiterte Szenarien zum Laden von Zertifikaten und privaten Schlüsseln können zum Aufzählen von PEM-codierten Werten und zum Anwenden eines benutzerdefinierten Ladeverhaltens verwendet PemEncoding werden.
Verwenden Sie CreateFromEncryptedPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>, ReadOnlySpan<Char>) für kennwortgeschützte PEM-codierte Schlüssel, um ein Kennwort anzugeben.