SecurityBindingElement 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
一个抽象类，在实现时表示支持通道 SOAP 消息安全的绑定元素。
public ref class SecurityBindingElement abstract : System::ServiceModel::Channels::BindingElementpublic abstract class SecurityBindingElement : System.ServiceModel.Channels.BindingElementtype SecurityBindingElement = class
inherit BindingElementPublic MustInherit Class SecurityBindingElement
Inherits BindingElement- 继承
- 派生
注解
此类是 WCF 中 SOAP 消息安全绑定元素的基类。 此抽象类有三种实现：SymmetricSecurityBindingElement、AsymmetricSecurityBindingElement 和 TransportSecurityBindingElement。 这些实现为在 WS-Security Policy 规范中定义的绑定建模。
自定义绑定包含以特定顺序排列的绑定元素集合：首先添加表示绑定堆栈顶部的元素，其次是绑定堆栈的第二个元素，依此类推。
若要将此类添加到绑定中，请执行下列操作：
在绑定堆栈中创建位于此绑定元素之上的自定义绑定元素，比如可选的 TransactionFlowBindingElement 和 ReliableSessionBindingElement。
使用 BindingElementCollection 方法，按先前描述的顺序将这些元素添加到 InsertItem。
创建一个派生自 SecurityBindingElement 的安全绑定元素的实例，如 AsymmetricSecurityBindingElement、SymmetricSecurityBindingElement 或 TransportSecurityBindingElement。
将派生的安全绑定元素添加到集合中。
将任何其他自定义绑定元素添加到集合，比如 TcpTransportBindingElement。
有关使用 的详细信息， SecurityBindingElement请参阅 SecurityBindingElement 身份验证模式 和 如何：使用 SecurityBindingElement 创建自定义绑定。
注意
在创建了 SecurityBindingElement 对象后，应将其属性视为不可变。 对某些属性调用 set 可能会产生不可预知的效果：绑定的行为可能就好像属性保留了其旧值一样，并出现运行时错误，该错误是问题的唯一迹象。 已知具有此行为的两个属性为 KeyType 和 MessageSecurityVersion。 其他某些属性可能也是如此。
属性
| AllowInsecureTransport |
获取或设置一个值，该值指示是否能通过不安全传输（如 HTTP）发送混合模式安全消息。 |
| DefaultAlgorithmSuite |
获取或设置消息加密和密钥换行算法。 |
| EnableUnsecuredResponse |
获取或设置一个值，该值指示 WCF 是否能发送和接收对安全请求的不安全响应。 |
| EndpointSupportingTokenParameters |
获取支持令牌参数的终结点。 |
| IncludeTimestamp |
获取或设置一个值，该值指示是否每条消息都包含时间戳。 |
| KeyEntropyMode |
获取或设置用于创建密钥的熵来源。 |
| LocalClientSettings |
获取由客户端使用的特定于本地安全设置的绑定属性。 |
| LocalServiceSettings |
获取由客户端使用的特定于本地安全设置的绑定属性。 |
| MessageSecurityVersion |
获取或设置消息安全版本。 |
| OperationSupportingTokenParameters |
获取操作支持令牌参数的集合。 |
| OptionalEndpointSupportingTokenParameters |
获取服务终结点的可选支持令牌参数。 |
| OptionalOperationSupportingTokenParameters |
获取可选操作支持令牌参数的集合。 |
| ProtectTokens |
获取或设置安全绑定元素是否保护令牌。 |
| SecurityHeaderLayout |
获取或设置此绑定的安全头中的元素排序。 |
方法
| BuildChannelFactory<TChannel>(BindingContext) |
基于 SecurityBindingElement 设置和传入的绑定上下文创建通道工厂。 创建的通道工厂为 SOAP 消息安全通道工厂，其内部有到对应绑定上下文的通道工厂的引用（包括传输通道工厂）。 |
| BuildChannelFactoryCore<TChannel>(BindingContext) |
实现时创建指定类型的通道工厂。 |
| BuildChannelListener<TChannel>(BindingContext) |
基于 SecurityBindingElement 设置和传入的绑定上下文创建通道侦听器。 |
| BuildChannelListener<TChannel>(BindingContext) |
初始化通道侦听器，用于接受绑定上下文中指定类型的通道。 (继承自 BindingElement) |
| BuildChannelListenerCore<TChannel>(BindingContext) |
实现时创建指定类型的通道侦听器。 |
| CanBuildChannelFactory<TChannel>(BindingContext) |
确定是否可生成指定类型的通道工厂。 |
| CanBuildChannelListener<TChannel>(BindingContext) |
确定是否可生成指定类型的通道侦听器。 |
| CanBuildChannelListener<TChannel>(BindingContext) |
返回一个值，该值指示绑定元素是否可以为特定类型的通道生成侦听器。 (继承自 BindingElement) |
| Clone() |
在派生类中重写时，返回绑定元素对象的副本。 (继承自 BindingElement) |
| CreateAnonymousForCertificateBindingElement() |
创建一个对称安全绑定元素，配置该元素以进行匿名客户端身份验证以及基于证书的服务器身份验证。 |
| CreateCertificateOverTransportBindingElement() |
创建一个安全绑定元素，该元素期望客户端使用 SOAP 消息安全执行基于证书的身份验证。 |
| CreateCertificateOverTransportBindingElement(MessageSecurityVersion) |
创建一个安全绑定元素，该元素期望客户端使用 SOAP 消息安全执行基于证书的身份验证。 |
| CreateCertificateSignatureBindingElement() |
创建使用证书签名消息的绑定元素。 此绑定元素仅可用于单向消息交换，且仅能签名消息。 |
| CreateIssuedTokenBindingElement(IssuedSecurityTokenParameters) |
创建一个对称安全绑定元素，该元素配置为需要使用基于对称密钥的颁发令牌进行客户端身份验证。 |
| CreateIssuedTokenForCertificateBindingElement(IssuedSecurityTokenParameters) |
创建一个对称安全绑定元素，该元素配置为需要基于已颁发令牌的客户端身份验证以及基于服务器证书的服务器身份验证。 |
| CreateIssuedTokenForSslBindingElement(IssuedSecurityTokenParameters) |
创建一个对称安全绑定元素，该元素配置为需要基于已颁发令牌的客户端身份验证以及基于服务器证书的服务器身份验证。 |
| CreateIssuedTokenForSslBindingElement(IssuedSecurityTokenParameters, Boolean) |
创建一个对称安全绑定元素，该元素配置为需要基于已颁发令牌的客户端身份验证以及基于服务器证书的服务器身份验证。 |
| CreateIssuedTokenOverTransportBindingElement(IssuedSecurityTokenParameters) |
创建一个对称安全绑定元素，该元素配置为需要使用颁发的令牌进行基于 SOAP 安全的客户端身份验证。 此绑定元素需要传输提供服务器身份验证和消息保护（例如 HTTPS）。 |
| CreateKerberosBindingElement() |
创建一个对称安全绑定元素，该元素配置为需要进行基于客户端的 Kerberos 令牌进行客户端身份验证。 |
| CreateKerberosOverTransportBindingElement() |
创建一个安全绑定元素，该元素配置为需要使用客户端 Kerberos 令牌进行基于 SOAP 安全的客户端身份验证。 此绑定元素需要传输提供服务器身份验证和消息保护（例如 HTTPS）。 |
| CreateMutualCertificateBindingElement() |
创建一个非对称安全绑定元素，该元素配置为需要基于证书的客户端身份验证以及基于证书的服务器身份验证。 |
| CreateMutualCertificateBindingElement(MessageSecurityVersion) |
创建一个非对称安全绑定元素，该元素配置为需要基于证书的客户端身份验证以及基于证书的服务器身份验证。 |
| CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean) |
创建一个非对称安全绑定元素，该元素配置为需要基于证书的客户端身份验证以及基于证书的服务器身份验证。 |
| CreateMutualCertificateDuplexBindingElement() |
创建一个非对称安全绑定元素，该元素配置为需要基于证书的客户端身份验证以及基于证书的服务器身份验证。 此身份验证模式可用于保护双工消息交换模式，它需要用带外客户端证书配置服务。 |
| CreateMutualCertificateDuplexBindingElement(MessageSecurityVersion) |
创建一个非对称安全绑定元素，该元素配置为需要基于证书的客户端身份验证以及基于证书的服务器身份验证。 此身份验证模式可用于保护双工消息交换模式，它需要用带外客户端证书配置服务。 |
| CreateSecureConversationBindingElement(SecurityBindingElement) |
创建一个对称安全绑定元素，该元素配置为可在客户端和服务之间建立安全的对话。 在安全对话握手结束时颁发的安全上下文令牌用于保护消息的安全。 启动安全绑定元素指定如何保护安全对话握手消息。 |
| CreateSecureConversationBindingElement(SecurityBindingElement, Boolean) |
创建一个对称安全绑定元素，该元素配置为可在客户端和服务之间建立安全的对话。 在安全对话握手结束时颁发的安全上下文令牌用于保护消息的安全。 |
| CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements) |
创建一个对称安全绑定元素，该元素配置为可在客户端和服务之间建立安全的对话。 在安全对话握手结束时颁发的安全上下文令牌用于保护消息的安全。 启动安全绑定元素指定如何保护安全对话握手消息。 |
| CreateSslNegotiationBindingElement(Boolean) |
创建一个对称安全绑定元素，该元素配置为可在客户端和服务器之间运行 SOAP 级别的 SSL 协商，并说明是否需要客户端证书。 |
| CreateSslNegotiationBindingElement(Boolean, Boolean) |
创建一个对称安全绑定元素，该元素执行 SOAP SSL 协商，并说明是否需要客户端证书和取消。 |
| CreateSspiNegotiationBindingElement() |
创建一个对称安全绑定元素，该元素基于协商身份验证包执行 SOAP SSPI 协商。 |
| CreateSspiNegotiationBindingElement(Boolean) |
创建一个对称安全绑定元素，该元素基于协商身份验证包执行 SOAP SSPI 协商。 |
| CreateSspiNegotiationOverTransportBindingElement() |
创建一个安全绑定元素，该元素配置为使用协商身份验证包基于 SOAP SSPI 协商进行客户端身份验证。 绑定元素需要传输提供服务器身份验证和消息保护（例如 HTTPS）。 |
| CreateSspiNegotiationOverTransportBindingElement(Boolean) |
创建一个安全绑定元素，该元素配置为使用协商身份验证包基于 SOAP SSPI 协商进行客户端身份验证。 绑定元素需要传输提供服务器身份验证和消息保护（例如 HTTPS）。 |
| CreateUserNameForCertificateBindingElement() |
创建一个对称安全绑定元素，该元素配置为需要基于用户名和密码的客户端身份验证以及基于证书的服务器身份验证。 在使用服务打开信道之前，创建的绑定元素需要使用带外服务证书配置客户端。 |
| CreateUserNameForSslBindingElement() |
创建一个对称安全绑定元素，该元素配置为需要基于用户名和密码的客户端身份验证以及基于证书的服务器身份验证。 客户端使用 SOAP 级别的 SSL 协议对服务器进行身份验证。 |
| CreateUserNameForSslBindingElement(Boolean) |
创建一个对称安全绑定元素，该元素配置为需要基于用户名和密码的客户端身份验证以及基于证书的服务器身份验证。 客户端使用 SOAP 级别的 SSL 协议对服务器进行身份验证。 |
| 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() |
返回对此类的描述。 |
