SecurityBindingElement 类

定义

命名空间:

System.ServiceModel.Channels

程序集:

System.ServiceModel.Primitives.dll

包:

System.ServiceModel.Primitives v6.2.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	获取或设置消息安全版本。
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 创建自定义绑定