Binding 类

定义

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.BasicHttpBinding

System.ServiceModel.Channels.CustomBinding

System.ServiceModel.HttpBindingBase

System.ServiceModel.MsmqBindingBase

System.ServiceModel.NetNamedPipeBinding

更多…

实现

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，对于其他传输，默认编码为二进制编码。

下表总结了每层的选项。

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

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

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

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

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