SecurityBindingElement 类

定义

命名空间:

System.ServiceModel.Channels

程序集:

System.ServiceModel.Primitives.dll

包:

System.ServiceModel.Primitives v8.0.0

Source:

SecurityBindingElement.cs

一个抽象类，在实现时表示支持通道 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	获取或设置用于创建密钥的熵来源。
LocalClientSettings	获取由客户端使用的特定于本地安全设置的绑定属性。
MessageSecurityVersion	获取或设置消息安全版本。
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）。
CreateSecureConversationBindingElement(SecurityBindingElement)	创建一个对称安全绑定元素，该元素配置为可在客户端和服务之间建立安全的对话。 在安全对话握手结束时颁发的安全上下文令牌用于保护消息的安全。 启动安全绑定元素指定如何保护安全对话握手消息。
CreateUserNameOverTransportBindingElement()	创建一个对称安全绑定元素，该元素配置为基于作为 SOAP 消息的组成部分发送的用户名和密码对客户端进行身份验证。 绑定元素需要传输提供服务器身份验证和消息保护（例如 HTTPS）。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetProperty<T>(BindingContext)	使用指定的 BindingContext 获取指定对象。
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回对此类的描述。

另请参阅

• SecurityBindingElement 身份验证模式
• 如何：使用 SecurityBindingElement 创建自定义绑定