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	获取或设置用于创建密钥的熵来源。 (继承自 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)	从 BindingContext 中获取指定的对象。
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
SetKeyDerivation(Boolean)	设置一个值，该值指示是否需要派生密钥。
ToString()	返回表示此 SymmetricSecurityBindingElement 实例的字符串。

显式接口实现

IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext)

导出有关绑定的自定义策略断言。

另请参阅

• 如何：为指定的身份验证模式创建 SecurityBindingElement