SymmetricSecurityBindingElement 類別

定義

命名空間:

System.ServiceModel.Channels

組件:

System.ServiceModel.dll

表示使用對稱加密支援通道安全性的自訂繫結項目。

public ref class SymmetricSecurityBindingElement sealed : System::ServiceModel::Channels::SecurityBindingElement, System::ServiceModel::Description::IPolicyExportExtension

public sealed class SymmetricSecurityBindingElement : System.ServiceModel.Channels.SecurityBindingElement, System.ServiceModel.Description.IPolicyExportExtension

type SymmetricSecurityBindingElement = class
    inherit SecurityBindingElement
    interface IPolicyExportExtension

Public NotInheritable Class SymmetricSecurityBindingElement
Inherits SecurityBindingElement
Implements IPolicyExportExtension

繼承

Object

BindingElement

SecurityBindingElement

SymmetricSecurityBindingElement

實作

IPolicyExportExtension

備註

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

若要將這個類別加入至繫結

1. 建立 BindingElementCollection。

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

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

4. 建立 SymmetricSecurityBindingElement 的執行個體，並將它新增至集合。

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

注意

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

建構函式

SymmetricSecurityBindingElement()	初始化 SymmetricSecurityBindingElement 類別的新執行個體。
SymmetricSecurityBindingElement(SecurityTokenParameters)	使用指定的安全性權杖參數，初始化 SymmetricSecurityBindingElement 類別的新執行個體。

屬性

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

方法

BuildChannelFactory<TChannel>(BindingContext)	根據傳入的 SecurityBindingElement 設定和繫結內容建立通道處理站。 所建立的通道處理站是 SOAP 訊息安全性通道處理站，其內部具有對應至繫結內容之通道處理站的參考 (包括傳輸通道處理站)。 (繼承來源 SecurityBindingElement)
BuildChannelFactoryCore<TChannel>(BindingContext)	當實作時會建立指定型別的通道處理站。 (繼承來源 SecurityBindingElement)
BuildChannelListener<TChannel>(BindingContext)	根據傳入的 SecurityBindingElement 設定和繫結內容建立通道接聽程式。 (繼承來源 SecurityBindingElement)
BuildChannelListenerCore<TChannel>(BindingContext)	當實作時會建立指定型別的通道接聽程式。 (繼承來源 SecurityBindingElement)
CanBuildChannelFactory<TChannel>(BindingContext)	判斷是否可以建置指定之型別的通道處理站。 (繼承來源 SecurityBindingElement)
CanBuildChannelListener<TChannel>(BindingContext)	判斷是否可以建置指定之型別的通道接聽項。 (繼承來源 SecurityBindingElement)
Clone()	建立從目前執行個體初始化之類別的新執行個體。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetProperty<T>(BindingContext)	從 中取得指定的物件。
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
SetKeyDerivation(Boolean)	設定值，指出是否需要衍生金鑰。
ToString()	傳回表示這個 SymmetricSecurityBindingElement 執行個體的字串。

明確介面實作

IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext)

匯出關於繫結的自訂原則判斷提示。

另請參閱

• 如何：為指定的驗證模式建立 SecurityBindingElement