SecurityBindingElement.CreateMutualCertificateBindingElement 方法

定義

命名空間:

System.ServiceModel.Channels

組件:

System.ServiceModel.dll

建立非對稱安全性繫結項目，這個項目則設定為需要進行憑證架構的用戶端驗證和伺服器驗證。

多載

CreateMutualCertificateBindingElement()	建立非對稱安全性繫結項目，這個項目則設定為需要進行憑證架構的用戶端驗證和伺服器驗證。
CreateMutualCertificateBindingElement(MessageSecurityVersion)	建立非對稱安全性繫結項目，這個項目則設定為需要進行憑證架構的用戶端驗證和伺服器驗證。
CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean)	建立非對稱安全性繫結項目，這個項目則設定為需要進行憑證架構的用戶端驗證和伺服器驗證。

備註

用戶端必須以它的憑證以及伺服器的憑證來設定。 伺服器必須使用它的憑證來設定。

CreateMutualCertificateBindingElement()

建立非對稱安全性繫結項目，這個項目則設定為需要進行憑證架構的用戶端驗證和伺服器驗證。

public:
 static System::ServiceModel::Channels::SecurityBindingElement ^ CreateMutualCertificateBindingElement();

public static System.ServiceModel.Channels.SecurityBindingElement CreateMutualCertificateBindingElement ();

static member CreateMutualCertificateBindingElement : unit -> System.ServiceModel.Channels.SecurityBindingElement

Public Shared Function CreateMutualCertificateBindingElement () As SecurityBindingElement

傳回

SecurityBindingElement

SecurityBindingElement 物件。

範例

下列程式碼將示範如何呼叫這個方法。

SecurityBindingElement security = SecurityBindingElement.CreateMutualCertificateBindingElement();

備註

繫結已設定成讓用戶端為每個要求產生新的隨機對稱金鑰 (為伺服器加密)，而且將該金鑰用於保護要求以及來自伺服器的回應。 用戶端的憑證是用來做為要求的簽署支援權杖。

實際上是建立 AsymmetricSecurityBindingElement。

CreateMutualCertificateBindingElement(MessageSecurityVersion)

建立非對稱安全性繫結項目，這個項目則設定為需要進行憑證架構的用戶端驗證和伺服器驗證。

public:
 static System::ServiceModel::Channels::SecurityBindingElement ^ CreateMutualCertificateBindingElement(System::ServiceModel::MessageSecurityVersion ^ version);

public static System.ServiceModel.Channels.SecurityBindingElement CreateMutualCertificateBindingElement (System.ServiceModel.MessageSecurityVersion version);

static member CreateMutualCertificateBindingElement : System.ServiceModel.MessageSecurityVersion -> System.ServiceModel.Channels.SecurityBindingElement

Public Shared Function CreateMutualCertificateBindingElement (version As MessageSecurityVersion) As SecurityBindingElement

參數

version

MessageSecurityVersion

訊息安全性版本。

傳回

SecurityBindingElement

SecurityBindingElement 物件。

例外狀況

ArgumentNullException

version 為 null。

備註

如果版本是 WSSecurity10，繫結項目便會設定成讓用戶端要求由其憑證簽署，並使用伺服器憑證加密。

如果版本是 WSSecurity11，繫結項目便會設定成讓用戶端為每個要求產生新的隨機對稱金鑰 (為伺服器加密)，而且將該金鑰用於保護要求以及來自伺服器的回應。 用戶端的憑證是用來做為要求的簽署支援權杖。

注意

一旦藉由呼叫這個方法建立 SecurityBindingElement 物件，MessageSecurityVersion 就是不變的屬性。 在上面呼叫 set 不會改變它。

CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean)

建立非對稱安全性繫結項目，這個項目則設定為需要進行憑證架構的用戶端驗證和伺服器驗證。

public:
 static System::ServiceModel::Channels::SecurityBindingElement ^ CreateMutualCertificateBindingElement(System::ServiceModel::MessageSecurityVersion ^ version, bool allowSerializedSigningTokenOnReply);

public static System.ServiceModel.Channels.SecurityBindingElement CreateMutualCertificateBindingElement (System.ServiceModel.MessageSecurityVersion version, bool allowSerializedSigningTokenOnReply);

static member CreateMutualCertificateBindingElement : System.ServiceModel.MessageSecurityVersion * bool -> System.ServiceModel.Channels.SecurityBindingElement

Public Shared Function CreateMutualCertificateBindingElement (version As MessageSecurityVersion, allowSerializedSigningTokenOnReply As Boolean) As SecurityBindingElement

參數

version

MessageSecurityVersion

訊息安全性版本。

allowSerializedSigningTokenOnReply

Boolean

回覆時允許序列化的簽署權杖則為 true，否則為 false。

傳回

SecurityBindingElement

SecurityBindingElement 物件。

例外狀況

ArgumentNullException

version 為 null。

備註

allowSerializedSigningTokenOnReply 參數如果為 true，便會啟用與舊版 Web Services Enhancements (WSE) 的互通性。

注意

一旦藉由呼叫這個方法建立 SecurityBindingElement 物件，就必須將 MessageSecurityVersion 當做不變的屬性。 如果修改這個值，便可能發生不一致的繫結行為。