Freigeben über


X509CertificateLoader.LoadPkcs12FromFile Methode

Definition

Überlädt

LoadPkcs12FromFile(String, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits)

Öffnet die angegebene Datei, liest den Inhalt als PKCS#12 PFX und extrahiert ein Zertifikat.

LoadPkcs12FromFile(String, String, X509KeyStorageFlags, Pkcs12LoaderLimits)

Öffnet die angegebene Datei, liest den Inhalt als PKCS#12 PFX und extrahiert ein Zertifikat.

LoadPkcs12FromFile(String, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits)

Quelle:
X509CertificateLoader.cs
Quelle:
X509CertificateLoader.cs

Öffnet die angegebene Datei, liest den Inhalt als PKCS#12 PFX und extrahiert ein Zertifikat.

public static System.Security.Cryptography.X509Certificates.X509Certificate2 LoadPkcs12FromFile (string path, ReadOnlySpan<char> password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet, System.Security.Cryptography.X509Certificates.Pkcs12LoaderLimits? loaderLimits = default);
static member LoadPkcs12FromFile : string * ReadOnlySpan<char> * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags * System.Security.Cryptography.X509Certificates.Pkcs12LoaderLimits -> System.Security.Cryptography.X509Certificates.X509Certificate2
Public Shared Function LoadPkcs12FromFile (path As String, password As ReadOnlySpan(Of Char), Optional keyStorageFlags As X509KeyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet, Optional loaderLimits As Pkcs12LoaderLimits = Nothing) As X509Certificate2

Parameter

path
String

Der Pfad der zu öffnenden Datei.

password
ReadOnlySpan<Char>

Das Kennwort zum Entschlüsseln des Inhalts der PFX.

keyStorageFlags
X509KeyStorageFlags

Eine bitweise Kombination der Enumerationswerte, die steuern, wo und wie der private Schlüssel importiert wird, der dem zurückgegebenen Zertifikat zugeordnet ist.

loaderLimits
Pkcs12LoaderLimits

Grenzwerte, die beim Laden der PFX gelten. Ein null-Wert, der Standardwert, entspricht Defaults.

Gibt zurück

Das geladene Zertifikat.

Ausnahmen

path ist null.

keyStorageFlags einen Ungültigen Wert oder eine Kombination aus Werten enthält.

keyStorageFlags enthält einen Wert, der für die aktuelle Plattform ungültig ist.

Die PKCS#12/PFX verletzte eine oder mehrere Einschränkungen von loaderLimits.

Fehler beim Laden der PKCS#12/PFX.

Fehler beim Laden der angegebenen Datei.

Hinweise

Ein PKCS#12/PFX kann mehrere Zertifikate enthalten. Mit der Reihenfolge, in der die Zertifikate in den Ergebnissen von LoadPkcs12CollectionFromFile(String, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits)angezeigt werden, gibt diese Methode das erste Zertifikat zurück, in dem HasPrivateKeytrueist. Wenn keine Zertifikate private Schlüssel zugeordnet haben, wird das erste Zertifikat zurückgegeben. Wenn die PKCS#12/PFX keine Zertifikate enthält, wird ein CryptographicException ausgelöst.

Gilt für:

LoadPkcs12FromFile(String, String, X509KeyStorageFlags, Pkcs12LoaderLimits)

Quelle:
X509CertificateLoader.cs
Quelle:
X509CertificateLoader.cs

Öffnet die angegebene Datei, liest den Inhalt als PKCS#12 PFX und extrahiert ein Zertifikat.

public static System.Security.Cryptography.X509Certificates.X509Certificate2 LoadPkcs12FromFile (string path, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet, System.Security.Cryptography.X509Certificates.Pkcs12LoaderLimits? loaderLimits = default);
static member LoadPkcs12FromFile : string * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags * System.Security.Cryptography.X509Certificates.Pkcs12LoaderLimits -> System.Security.Cryptography.X509Certificates.X509Certificate2
Public Shared Function LoadPkcs12FromFile (path As String, password As String, Optional keyStorageFlags As X509KeyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet, Optional loaderLimits As Pkcs12LoaderLimits = Nothing) As X509Certificate2

Parameter

path
String

Der Pfad der zu öffnenden Datei.

password
String

Das Kennwort zum Entschlüsseln des Inhalts der PFX.

keyStorageFlags
X509KeyStorageFlags

Eine bitweise Kombination der Enumerationswerte, die steuern, wo und wie der private Schlüssel importiert wird, der dem zurückgegebenen Zertifikat zugeordnet ist.

loaderLimits
Pkcs12LoaderLimits

Grenzwerte, die beim Laden der PFX gelten. Ein null-Wert, der Standardwert, entspricht Defaults.

Gibt zurück

Das geladene Zertifikat.

Ausnahmen

path ist null.

keyStorageFlags einen Ungültigen Wert oder eine Kombination aus Werten enthält.

keyStorageFlags enthält einen Wert, der für die aktuelle Plattform ungültig ist.

Die PKCS#12/PFX verletzte eine oder mehrere Einschränkungen von loaderLimits.

Fehler beim Laden der PKCS#12/PFX.

Fehler beim Laden der angegebenen Datei.

Hinweise

Ein PKCS#12/PFX kann mehrere Zertifikate enthalten. Mit der Reihenfolge, in der die Zertifikate in den Ergebnissen von LoadPkcs12CollectionFromFile(String, String, X509KeyStorageFlags, Pkcs12LoaderLimits)angezeigt werden, gibt diese Methode das erste Zertifikat zurück, in dem HasPrivateKeytrueist. Wenn keine Zertifikate private Schlüssel zugeordnet haben, wird das erste Zertifikat zurückgegeben. Wenn die PKCS#12/PFX keine Zertifikate enthält, wird ein CryptographicException ausgelöst.

Gilt für: