X509CertificateInitiatorServiceCredential.SetCertificate 方法

定义

命名空间:

System.ServiceModel.Security

程序集:

System.ServiceModel.dll

设置证书，该证书用于加密由服务发送给客户端的消息。 此设置只能由使用 MutualCertificateDuplex 消息安全身份验证模式配置的绑定使用。

重载

SetCertificate(String, StoreLocation, StoreName)	使您可以通过指定主题可分辨名称指定用于加密客户端消息的证书。 此设置只能由使用 MutualCertificateDuplex 消息安全身份验证模式配置的绑定使用。
SetCertificate(StoreLocation, StoreName, X509FindType, Object)	指定要用于加密客户端消息的证书。 此设置只能由使用 MutualCertificateDuplex 消息安全身份验证模式配置的绑定使用。

SetCertificate(String, StoreLocation, StoreName)

使您可以通过指定主题可分辨名称指定用于加密客户端消息的证书。 此设置只能由使用 MutualCertificateDuplex 消息安全身份验证模式配置的绑定使用。

public:
 void SetCertificate(System::String ^ subjectName, System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName);

public void SetCertificate (string subjectName, System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName);

member this.SetCertificate : string * System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName -> unit

Public Sub SetCertificate (subjectName As String, storeLocation As StoreLocation, storeName As StoreName)

参数

subjectName

String

该主题可分辨名称。

storeLocation

StoreLocation

服务用于获取证书的证书存储区位置。

storeName

StoreName

要打开的 X.509 证书存储区的名称。

示例

下面的代码演示如何使用此方法设置证书。

注解

有关 subjectName 参数的更多信息，请参见SubjectName。

storeLocation 的值包含在 StoreLocation 枚举中：

• LocalMachine：分配给本地计算机的证书存储区（默认）。

• CurrentUser：当前用户所使用的证书存储区。

如果客户端应用程序在系统帐户下运行，则证书通常位于 LocalMachine。 如果客户端应用程序在用户帐户下运行，则证书通常位于 CurrentUser。

storeName 的值包含在 StoreName 枚举中。

SetCertificate(StoreLocation, StoreName, X509FindType, Object)

指定要用于加密客户端消息的证书。 此设置只能由使用 MutualCertificateDuplex 消息安全身份验证模式配置的绑定使用。

public:
 void SetCertificate(System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName, System::Security::Cryptography::X509Certificates::X509FindType findType, System::Object ^ findValue);

public void SetCertificate (System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName, System.Security.Cryptography.X509Certificates.X509FindType findType, object findValue);

member this.SetCertificate : System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName * System.Security.Cryptography.X509Certificates.X509FindType * obj -> unit

Public Sub SetCertificate (storeLocation As StoreLocation, storeName As StoreName, findType As X509FindType, findValue As Object)

参数

storeLocation

StoreLocation

服务用于获取证书的证书存储区位置。

storeName

StoreName

要打开的 X.509 证书存储区的名称。

findType

X509FindType

要执行的 X.509 搜索的类型。

findValue

Object

要在 X.509 证书存储区中搜索的值。

示例

下面的代码演示如何使用此方法设置证书。

注解

storeLocation 的值包含在 StoreLocation 枚举中：

• LocalMachine：分配给本地计算机的证书存储区（默认）。

• CurrentUser：当前用户所使用的证书存储区。

如果应用程序在系统帐户下运行，则证书通常位于 LocalMachine。 如果应用程序在用户帐户下运行，则证书通常位于 CurrentUser。

storeName 的值包含在 StoreName 枚举中。

findType 的值包含在 X509FindType 枚举中。

最常用的枚举是 FindBySubjectName，它在指定存储区中对证书的主题名称执行不区分大小写的搜索。 这可能是不精确的搜索。 如果未找到证书或找到了多个与条件相匹配的证书，则将引发 InvalidOperationException。