Binding 类

定义

命名空间:

System.ServiceModel.Channels

程序集:

System.ServiceModel.Primitives.dll

包:

System.ServiceModel.Primitives v6.2.0

包含绑定元素，这些元素指定客户端和服务之间的通信所用的协议、传输和消息编码器。

public ref class Binding abstract : System::ServiceModel::IDefaultCommunicationTimeouts

public abstract class Binding : System.ServiceModel.IDefaultCommunicationTimeouts

type Binding = class
    interface IDefaultCommunicationTimeouts

Public MustInherit Class Binding
Implements IDefaultCommunicationTimeouts

继承

Object

Binding

派生

System.ServiceModel.Channels.CustomBinding

System.ServiceModel.HttpBindingBase

System.ServiceModel.MsmqBindingBase

System.ServiceModel.NetNamedPipeBinding

System.ServiceModel.NetPeerTcpBinding

System.ServiceModel.NetTcpBinding

System.ServiceModel.UdpBinding

System.ServiceModel.WebHttpBinding

System.ServiceModel.WSDualHttpBinding

System.ServiceModel.WSHttpBindingBase

实现

IDefaultCommunicationTimeouts

示例

BasicHttpBinding binding = new BasicHttpBinding();

binding.Name = "binding1";

Uri baseAddress = new Uri("http://localhost:8000/servicemodelsamples/service");
Uri address = new Uri("http://localhost:8000/servicemodelsamples/service/calc");

// Create a ServiceHost for the CalculatorService type and provide the base address.
using (ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService), baseAddress))
{
    serviceHost.AddServiceEndpoint(typeof(ICalculator), binding, address);

    // Open the ServiceHostBase to create listeners and start listening for messages.
    serviceHost.Open();

    // The service can now be accessed.
    Console.WriteLine("The service is ready.");
    Console.WriteLine("Press <ENTER> to terminate service.");
    Console.WriteLine();
    Console.ReadLine();
    // Close the ServiceHostBase to shutdown the service.
    serviceHost.Close();
}

注解

表示一个绑定元素集合，其中每一个元素都描述一个终结点与其他终结点的通信方式的一个方面，这些元素一致地内置到客户端上的通道工厂和服务上的通道侦听器中。 绑定包含绑定元素集合，这些元素与协议通道、传输通道和消息编码器相对应。 协议通道可以有任意数目的绑定元素，但是每个传输通道和消息编码器都有且只有一个绑定元素。 一个绑定中通常有六层绑定元素。 只有堆栈底部的传输和编码绑定元素是必需的。 由于每个绑定都需要编码，如果未指定编码，Windows Communication Foundation (WCF) 会为你添加默认编码。 对于 HTTP 和 HTTPS 传输，默认编码是 Text/XML，对于其他传输，默认编码为二进制编码。

下表总结了每层的选项。

层	选项	必须
事务流	TransactionFlowBindingElement	否
可靠性	ReliableSessionBindingElement	否
安全性	对称、非对称、传输级	否
形状更改	CompositeDuplexBindingElement	否
传输升级	SSL 流、Windows 流、对等解析程序	否
编码	文本、二进制、MTOM、自定义	是
Transport	TCP、命名管道、HTTP、HTTPS、MSMQ、自定义	是

每个绑定元素都提供在客户端上生成通道工厂和在服务上生成通道侦听器的规范。 例如，在构建通道工厂堆栈时，对于绑定中的每个绑定元素，堆栈中都有一个通道工厂。 在服务上，堆栈中的通道侦听器也具有同样的对应关系。 客户端和服务上的一致性对于在这些终结点之间建立基于通道的连接非常重要。 这样，每个工厂和侦听器才能处理通道堆栈中与之连接的相应通道的发送和接收操作，然后，这些通道才能发送和接收用于通信的消息。

每个 Binding 实例都具有 Name 和 Namespace，它们结合起来在服务的元数据中唯一标识每个实例。 如果未指定名称或命名空间，WCF 会为你添加默认值。 默认名称为 null ，默认命名空间为 http://tempuri.org/。 绑定的这一用户名不同于协议名称的规范，后者由 Scheme 属性指定。 例如，如果要添加更多 HTTP 绑定，可以将它们命名为任何名称，并可将其所有架构都设置为“http”。 不存在基于 Scheme 的固有应用程序或计算机调度。 这样，就避免了一个常见问题，即无法为已知协议注册附加处理程序。 通过给每个版本提供不同的名称，还可以轻松地并行使用一个绑定的多个版本。

Binding 类实现 IDefaultCommunicationTimeouts 接口，从而减少通过长时间占用资源来实施的拒绝服务 (DOS) 攻击。 该实现指定打开和关闭连接的通信超时值，以及与接收和发送消息相关联的读写操作的通信超时值。 用于获取和设置这些超时值的属性及其默认值操作总结在下表中。

超时属性	默认值
OpenTimeout	1 分钟
CloseTimeout	1 分钟
SendTimeout	1 分钟
ReceiveTimeout	10 分钟

通过继承 Binding 创建绑定时，必须重写 CreateBindingElements。

此外，还可以定义自己的绑定元素，并将它们插入到前面表中定义的任何层之间。 有关更多信息，请参见 CustomBinding 类。

构造函数

Binding()	使用默认的名称和命名空间初始化 Binding 类的新实例。
Binding(String, String)	使用指定的服务绑定初始化 Binding 类的新实例。

属性

CloseTimeout	获取或设置在传输引发异常之前可用于关闭连接的时间间隔。
MessageVersion	获取由绑定所配置的客户端和服务使用的消息版本。
Name	获取或设置绑定的名称。
Namespace	获取或设置绑定的 XML 命名空间。
OpenTimeout	获取或设置在传输引发异常之前可用于打开连接的时间间隔。
ReceiveTimeout	获取或设置连接在撤消之前保持非活动状态的最大时间间隔，在此时间间隔内未接收任何应用程序消息。
Scheme	在派生类中实现时，设置 URI 架构，此架构指定由绑定生成的通道和侦听器工厂所使用的传输。
SendTimeout	获取或设置在传输引发异常之前可用于完成写入操作的时间间隔。

方法

BuildChannelFactory<TChannel>(BindingParameterCollection)	在客户端上生成通道工厂堆栈，此通道工厂堆栈创建具有指定类型的通道并满足绑定参数集合所指定的功能。
BuildChannelFactory<TChannel>(Object[])	在客户端上生成通道工厂堆栈，该通道工厂堆栈创建具有指定类型的通道并满足对象数组所指定的功能。
CanBuildChannelFactory<TChannel>(BindingParameterCollection)	返回一个值，该值指示当前绑定是否可以在客户端上生成满足指定绑定参数集合的通道工厂堆栈。
CanBuildChannelFactory<TChannel>(Object[])	返回一个值，该值指示当前绑定是否可以在客户端上生成满足对象数组所指定的需求的通道工厂堆栈。
CreateBindingElements()	在派生类中重写时，创建一个集合，该集合包含属于当前绑定的绑定元素。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetProperty<T>(BindingParameterCollection)	从绑定堆栈的适当层返回所请求的类型化对象（如果存在）。
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前对象的字符串。 (继承自 Object)