NetTcpBinding 类

定义

命名空间:

System.ServiceModel

程序集:

System.ServiceModel.dll, System.ServiceModel.NetTcp.dll

包:

System.ServiceModel.NetTcp v10.0.652802, System.ServiceModel.Primitives v10.0.652802

Source:

NetTcpBinding.cs

适用于跨计算机通信的安全可靠绑定。

public ref class NetTcpBinding : System::ServiceModel::Channels::Binding

public class NetTcpBinding : System.ServiceModel.Channels.Binding

type NetTcpBinding = class
    inherit Binding

Public Class NetTcpBinding
Inherits Binding

继承

Object

Binding

NetTcpBinding

派生

System.ServiceModel.NetTcpContextBinding

示例

此示例演示如何创建、 NetTcpBinding设置安全模式和传输凭据类型。

NetTcpBinding binding = new NetTcpBinding();
binding.Security.Mode = SecurityMode.Transport;
binding.Security.Transport.ClientCredentialType = TcpClientCredentialType.Certificate;

注解

默认情况下，生成 NetTcpBinding 运行时通信堆栈，该堆栈使用传输安全性、TCP 进行消息传递和二进制消息编码。 此绑定是适当的 Windows Communication Foundation （WCF） 系统提供的用于通过 Intranet 进行通信的选择。

默认配置的速度比提供的NetTcpBinding配置WSHttpBinding更快，但仅用于 WCF 通信。 可以使用构造函数中的可选 securityMode 参数配置安全行为。 可以使用可选 reliableSessionEnabled 参数配置 WS-ReliableMessaging。 但默认情况下，可靠消息传送处于关闭状态。 更普遍的是，HTTP 系统提供的绑定（例如 WSHttpBinding ，并 BasicHttpBinding 配置为在默认情况下打开内容），而默认情况下绑定 NetTcpBinding 会关闭某些内容，以便你必须选择加入以获取支持，例如，对于其中一个 WS-* 规范。 这意味着 TCP 的默认配置在终结点之间交换消息的速度比默认情况下为 HTTP 绑定配置的要快。

Warning

它 NetTcpBinding 使用基于服务的主机 DNS 名称和服务正在侦听的端口号的 TCP 连接池。 当客户端在不同端口上调用不同的服务，或者服务托管在单个进程中并共享端口时，这一点非常有效。 如果单个客户端调用多个服务，共享在不同进程中托管的端口，或者托管了 WAS/IIS，则客户端池可能会导致服务 B 重用到服务 A 的连接的问题，从而导致引发异常、连接中止，并创建了一个新通道。 若要避免此问题，请使用 CustomBinding 并为客户端与之通信的每个服务指定不同的 ConnectionPoolSettings.GroupName。

构造函数

名称	说明
NetTcpBinding()	初始化 NetTcpBinding 类的新实例。
NetTcpBinding(SecurityMode, Boolean)	使用指定的安全类型以及指示是否显式启用可靠会话的值初始化类的新实例 NetTcpBinding 。
NetTcpBinding(SecurityMode)	使用指定的安全类型初始化类的新实例 NetTcpBinding 。

属性

名称	说明
CloseTimeout	获取或设置在传输引发异常之前连接要关闭的时间间隔。 (继承自 Binding)
EnvelopeVersion	获取用于此绑定处理的消息的 SOAP 版本。
MaxBufferPoolSize	获取或设置存储绑定处理的 TCP 消息的缓冲池允许的最大大小（以字节为单位）。
MaxBufferSize	获取或设置一个值，该值指定用于在内存中存储消息的缓冲区的最大大小（以字节为单位）。
MaxConnections	获取或设置一个值，该值控制要在客户端上进行后续重用的最大连接数，以及允许在服务器上挂起调度的最大连接数。
MaxReceivedMessageSize	获取或设置绑定处理的接收消息的最大大小（以字节为单位）。
MessageVersion	获取使用绑定配置的客户端和服务使用的消息版本。 (继承自 Binding)
Name	获取或设置绑定的名称。 (继承自 Binding)
Namespace	获取或设置绑定的 XML 命名空间。 (继承自 Binding)
OpenTimeout	获取或设置在传输引发异常之前为连接打开提供的时间间隔。 (继承自 Binding)
ReaderQuotas	获取或设置 SOAP 消息的复杂性约束，这些消息可由配置有此绑定的终结点处理。
ReceiveTimeout	获取或设置连接在删除之前连接可以保持非活动状态的时间间隔，在此期间不会收到任何应用程序消息。 (继承自 Binding)
ReliableSession	获取一个对象，该对象指示是否在通道终结点之间建立可靠会话。
Scheme	返回传输的 URI 方案。
Security	获取一个对象，该对象指定用于配置此绑定的服务的安全类型。
SendTimeout	获取或设置传输引发异常之前为写入操作完成提供的时间间隔。 (继承自 Binding)
TransferMode	获取或设置一个值，该值指示使用绑定配置的服务是使用流传输模式还是缓冲模式（或两种模式）。

方法

名称	说明
BuildChannelFactory<TChannel>(BindingParameterCollection)	在客户端上生成通道工厂堆栈，该堆栈创建指定的通道类型并满足绑定参数集合指定的功能。 (继承自 Binding)
BuildChannelFactory<TChannel>(Object[])	在客户端上生成通道工厂堆栈，该堆栈创建指定的通道类型并满足对象数组指定的功能。 (继承自 Binding)
CanBuildChannelFactory<TChannel>(BindingParameterCollection)	返回一个值，该值指示当前绑定是否可以在客户端上生成满足指定绑定参数集合的通道工厂堆栈。 (继承自 Binding)
CanBuildChannelFactory<TChannel>(Object[])	返回一个值，该值指示当前绑定是否可以在客户端上生成满足对象数组指定的要求的通道工厂堆栈。 (继承自 Binding)
CreateBindingElements()	使用绑定的绑定元素创建集合。
GetProperty<T>(BindingParameterCollection)	从绑定堆栈中的相应层返回所请求的类型化对象（如果存在）。 (继承自 Binding)