你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

CertificateClient.DownloadCertificate 方法

参考

定义

命名空间:: Azure.Security.KeyVault.Certificates

程序集:: Azure.Security.KeyVault.Certificates.dll

包:: Azure.Security.KeyVault.Certificates v4.6.0

包:: Azure.Security.KeyVault.Certificates v4.6.0-beta.2

重要

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

重载

DownloadCertificate(DownloadCertificateOptions, CancellationToken)	从指定的证书创建。X509Certificate2
DownloadCertificate(String, String, CancellationToken)	从指定的证书创建。X509Certificate2

DownloadCertificate(DownloadCertificateOptions, CancellationToken)

Source:: CertificateClient.cs

Source:: CertificateClient.cs

从指定的证书创建。X509Certificate2

public virtual Azure.Response<System.Security.Cryptography.X509Certificates.X509Certificate2> DownloadCertificate (Azure.Security.KeyVault.Certificates.DownloadCertificateOptions options, System.Threading.CancellationToken cancellationToken = default);

abstract member DownloadCertificate : Azure.Security.KeyVault.Certificates.DownloadCertificateOptions * System.Threading.CancellationToken -> Azure.Response<System.Security.Cryptography.X509Certificates.X509Certificate2>
override this.DownloadCertificate : Azure.Security.KeyVault.Certificates.DownloadCertificateOptions * System.Threading.CancellationToken -> Azure.Response<System.Security.Cryptography.X509Certificates.X509Certificate2>

Public Overridable Function DownloadCertificate (options As DownloadCertificateOptions, Optional cancellationToken As CancellationToken = Nothing) As Response(Of X509Certificate2)

参数

options: DownloadCertificateOptions

用于下载和创建的选项 X509Certificate2。

cancellationToken: CancellationToken

控制 CancellationToken 请求生存期的。

Response<X509Certificate2>

X509Certificate2来自指定证书的。

例外

ArgumentNullException

options 为 null。

InvalidDataException

托管机密不包含证书。

NotSupportedException

CertificateContentType不支持。

PlatformNotSupportedException

无法在此平台上创建。X509Certificate2

RequestFailedException

请求失败。有关详细信息，请参阅 ErrorCode 和异常消息。

注解

由于 Cer 仅包含公钥，因此此方法尝试下载包含完整证书的托管机密。如果你没有获取机密的权限， RequestFailedException 则会引发相应的错误响应。如果想要 X509Certificate2 仅包含公钥的，请实例化它，仅传递属性 Cer 。此操作需要 certificates/get 和 secrets/get 权限。

适用于

DownloadCertificate(String, String, CancellationToken)

Source:: CertificateClient.cs

Source:: CertificateClient.cs

从指定的证书创建。X509Certificate2

public virtual Azure.Response<System.Security.Cryptography.X509Certificates.X509Certificate2> DownloadCertificate (string certificateName, string version = default, System.Threading.CancellationToken cancellationToken = default);

abstract member DownloadCertificate : string * string * System.Threading.CancellationToken -> Azure.Response<System.Security.Cryptography.X509Certificates.X509Certificate2>
override this.DownloadCertificate : string * string * System.Threading.CancellationToken -> Azure.Response<System.Security.Cryptography.X509Certificates.X509Certificate2>

Public Overridable Function DownloadCertificate (certificateName As String, Optional version As String = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Response(Of X509Certificate2)