Binding 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
包含绑定元素,这些元素指定客户端和服务之间的通信所用的协议、传输和消息编码器。
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
- 继承
-
Binding
- 派生
- 实现
示例
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 |
获取或设置在传输引发异常之前可用于完成写入操作的时间间隔。 |