X509CertificateLoader.LoadPkcs12 方法

参考

定义

命名空间:: System.Security.Cryptography.X509Certificates

程序集:: Microsoft.Bcl.Cryptography.dll

程序集:: System.Security.Cryptography.dll

包:: Microsoft.Bcl.Cryptography v9.0.0-rc.1.24431.7

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

LoadPkcs12(Byte[], String, X509KeyStorageFlags, Pkcs12LoaderLimits)	以 PKCS#12 PFX 的形式加载所提供的数据并提取证书。
LoadPkcs12(ReadOnlySpan<Byte>, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits)	以 PKCS#12 PFX 的形式加载所提供的数据并提取证书。

LoadPkcs12(Byte[], String, X509KeyStorageFlags, Pkcs12LoaderLimits)

Source:: X509CertificateLoader.cs

以 PKCS#12 PFX 的形式加载所提供的数据并提取证书。

public static System.Security.Cryptography.X509Certificates.X509Certificate2 LoadPkcs12 (byte[] data, string? password, System.Security.Cryptography.X509Certificates.X509KeyStorageFlags keyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet, System.Security.Cryptography.X509Certificates.Pkcs12LoaderLimits? loaderLimits = default);

static member LoadPkcs12 : byte[] * string * System.Security.Cryptography.X509Certificates.X509KeyStorageFlags * System.Security.Cryptography.X509Certificates.Pkcs12LoaderLimits -> System.Security.Cryptography.X509Certificates.X509Certificate2

Public Shared Function LoadPkcs12 (data As Byte(), password As String, Optional keyStorageFlags As X509KeyStorageFlags = System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.DefaultKeySet, Optional loaderLimits As Pkcs12LoaderLimits = Nothing) As X509Certificate2

参数

data: Byte[]

要加载的数据。

password: String

用于解密 PFX 内容的密码。

keyStorageFlags: X509KeyStorageFlags

枚举值的按位组合，用于控制与返回的证书关联的私钥的位置以及如何导入。

loaderLimits: Pkcs12LoaderLimits

加载 PFX 时要应用的限制。默认值 null 值等效于 Defaults。

X509Certificate2

已加载的证书。

例外

ArgumentNullException

data null。

ArgumentException

keyStorageFlags 包含无效的值或值的组合。

PlatformNotSupportedException

keyStorageFlags 包含对当前平台无效的值。

Pkcs12LoadLimitExceededException

PKCS#12/PFX 违反了一个或多个 loaderLimits约束。

CryptographicException

加载 PKCS#12/PFX 时出错。

注解

PKCS#12/PFX 可以包含多个证书。使用证书显示在 LoadPkcs12Collection(ReadOnlySpan<Byte>, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits)结果中的排序，此方法返回第一个证书，其中 HasPrivateKeytrue。如果没有证书具有关联的私钥，则返回第一个证书。如果 PKCS#12/PFX 不包含证书，则会引发 CryptographicException。

适用于

LoadPkcs12(ReadOnlySpan<Byte>, ReadOnlySpan<Char>, X509KeyStorageFlags, Pkcs12LoaderLimits)

Source:: X509CertificateLoader.cs