SecurityBindingElement 類別

定義

命名空間:

System.ServiceModel.Channels

組件:

System.ServiceModel.Primitives.dll

套件:

System.ServiceModel.Primitives v6.2.0

Source:

SecurityBindingElement.cs

抽象類別 (Abstract Class)，其在實作時可表示支援通道 SOAP 訊息安全性的繫結項目。

public ref class SecurityBindingElement abstract : System::ServiceModel::Channels::BindingElement

public abstract class SecurityBindingElement : System.ServiceModel.Channels.BindingElement

type SecurityBindingElement = class
    inherit BindingElement

Public MustInherit Class SecurityBindingElement
Inherits BindingElement

繼承

Object

BindingElement

SecurityBindingElement

衍生

System.ServiceModel.Channels.AsymmetricSecurityBindingElement

System.ServiceModel.Channels.SymmetricSecurityBindingElement

System.ServiceModel.Channels.TransportSecurityBindingElement

備註

這個類別是 WCF 中 SOAP 訊息安全性綁定項的基類。 這個抽象類別有三種實作：SymmetricSecurityBindingElement、AsymmetricSecurityBindingElement 和 TransportSecurityBindingElement。 這些實作會建立以 WS-Security Policy 規格定義之繫結的模型。

自訂繫結包含以特定順序排列的繫結項目之集合：第一個會新增代表繫結堆疊頂端的項目，第二個新增繫結堆疊中次一項目，依此類推。

若要將這個類別新增至繫結，請執行下列動作：

1. 建立 BindingElementCollection。

2. 建立在繫結堆疊中位於此繫結項目上方的自訂繫結項目，例如選擇性的 TransactionFlowBindingElement 和 ReliableSessionBindingElement。

3. 依先前所述的順序，使用 BindingElementCollection 方法將這些項目新增至 InsertItem。

4. 建立自 SecurityBindingElement 衍生之安全性繫結項目的執行個體，例如 AsymmetricSecurityBindingElement、SymmetricSecurityBindingElement 或 TransportSecurityBindingElement。

5. 將衍生的安全性繫結項目新增至集合。

6. 將其他任何自訂繫結項目新增至集合中，例如 TcpTransportBindingElement。

如需使用 SecurityBindingElement的詳細資訊，請參閱 SecurityBindingElement 驗證模式 和 如何：使用 SecurityBindingElement 建立自定義系結。

注意

一旦建立 SecurityBindingElement 物件之後，您就應該將它的屬性視為不變的屬性。 在某些屬性上呼叫 set 可能會產生無法預測的結果：繫結的行為可能如同屬性保留舊的值一般，而且執行階段錯誤是發生問題的唯一徵兆。 已知可能出現這種行為的兩個屬性是 KeyType 和 MessageSecurityVersion。 另外可能還有其他屬性也會出現同樣的狀況。

屬性

DefaultAlgorithmSuite	取得或設定訊息加密和金鑰包裝演算法。
EnableUnsecuredResponse	取得或設定值，這個值表示 WCF 是否可以接收及傳送不安全的回應至安全的要求。
EndpointSupportingTokenParameters	取得支援權杖參數的端點。
IncludeTimestamp	取得或設定值，指出時間戳記是否包含在各個訊息中。
KeyEntropyMode	取得或設定用於建立金鑰的 Entropy 來源。
LocalClientSettings	取得用戶端所使用本機安全性設定的特定繫結項目。
MessageSecurityVersion	取得或設定訊息安全性版本。
OperationSupportingTokenParameters	取得支援權杖參數之作業的集合。
OptionalEndpointSupportingTokenParameters	取得服務端點的選擇性支援權杖參數。
OptionalOperationSupportingTokenParameters	取得支援權杖參數之選擇性作業的集合。
SecurityHeaderLayout	取得或設定此繫結之安全性標頭中的項目順序。

方法

BuildChannelFactory<TChannel>(BindingContext)	根據傳入的 SecurityBindingElement 設定和繫結內容建立通道處理站。 所建立的通道處理站是 SOAP 訊息安全性通道處理站，其內部具有對應至繫結內容之通道處理站的參考 (包括傳輸通道處理站)。
BuildChannelFactoryCore<TChannel>(BindingContext)	當實作時會建立指定型別的通道處理站。
BuildChannelListener<TChannel>(BindingContext)	初始化通道接聽項，以便從繫結內容接受指定之類型的通道。 (繼承來源 BindingElement)
CanBuildChannelFactory<TChannel>(BindingContext)	判斷是否可以建置指定之型別的通道處理站。
CanBuildChannelListener<TChannel>(BindingContext)	傳回值，指出繫結項目是否可以建置特定通道型別的通道接聽程式。 (繼承來源 BindingElement)
Clone()	在衍生類別中覆寫時，傳回繫結項目物件的複本。 (繼承來源 BindingElement)
CreateCertificateOverTransportBindingElement()	建立安全性繫結項目，這個項目需要用戶端使用 SOAP 訊息安全性執行憑證架構的驗證。
CreateCertificateOverTransportBindingElement(MessageSecurityVersion)	建立安全性繫結項目，這個項目需要用戶端使用 SOAP 訊息安全性執行憑證架構的驗證。
CreateIssuedTokenOverTransportBindingElement(IssuedSecurityTokenParameters)	建立安全性繫結項目，該項目已設定為需要使用發行之權杖的 SOAP 安全性用戶端驗證。 這個繫結項目需要傳輸提供伺服器驗證和訊息保護 (例如 HTTPS)。
CreateMutualCertificateBindingElement()	建立非對稱安全性繫結項目，這個項目則設定為需要進行憑證架構的用戶端驗證和伺服器驗證。
CreateMutualCertificateBindingElement(MessageSecurityVersion)	建立非對稱安全性繫結項目，這個項目則設定為需要進行憑證架構的用戶端驗證和伺服器驗證。
CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean)	建立非對稱安全性繫結項目，這個項目則設定為需要進行憑證架構的用戶端驗證和伺服器驗證。
CreateSecureConversationBindingElement(SecurityBindingElement)	建立對稱式安全性繫結項目，這個項目則設定為建立用戶端與服務之間的安全對話。 在安全對話交換結束時發出的安全性內容權杖是用來確保這些訊息的安全。 啟動安裝安全性繫結項目會指定如何保護安全對話交換訊息。
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)	建立對稱式安全性繫結項目，這個項目則設定為建立用戶端與服務之間的安全對話。 在安全對話交換結束時發出的安全性內容權杖是用來確保這些訊息的安全。
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)	建立對稱式安全性繫結項目，這個項目則設定為建立用戶端與服務之間的安全對話。 在安全對話交換結束時發出的安全性內容權杖是用來確保這些訊息的安全。 啟動安裝安全性繫結項目會指定如何保護安全對話交換訊息。
CreateUserNameOverTransportBindingElement()	建立安全性繫結項目，這個項目則設定為以 SOAP 訊息傳送之一部分的使用者名稱和密碼為基礎的用戶端驗證。 這個繫結項目需要傳輸提供伺服器驗證和訊息保護 (例如 HTTPS)。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetProperty<T>(BindingContext)	取得使用指定之 BindingContext 的指定物件。
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
SetIssuerBindingContextIfRequired(SecurityTokenParameters, BindingContext)	設定權杖需求屬性的索引鍵，如果是有關已發行權杖的需求，其值便會是用來與發行方溝通的 BindingContext。
SetKeyDerivation(Boolean)	設定值，指出是否需要衍生金鑰。
ToString()	傳回這個類別的描述。

另請參閱

• SecurityBindingElement 驗證模式
• 如何：使用 SecurityBindingElement 建立自定義系結