NetTcpBinding 类nettcpbinding的属性和方法

 

 

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

继承层次结构

 

System.Object 
  System.ServiceModel.Channels.Binding
    System.ServiceModel.NetTcpBinding
      System.ServiceModel.NetTcpContextBinding

 

命名空间：  System.ServiceModel
程序集：  System.ServiceModel（在 System.ServiceModel.dll 中）

语法

 

C#

C++

F#

VB

 

public class NetTcpBinding : Binding, 
	IBindingRuntimePreferences

NetTcpBinding 类型公开以下成员。

构造函数

 

显示: 继承 保护

	名称	说明
	NetTcpBinding()	初始化 NetTcpBinding 类的新实例。
	NetTcpBinding(SecurityMode)	用所使用的指定安全类型初始化 NetTcpBinding 类的新实例。
	NetTcpBinding(String)	使用指定配置名称初始化 NetTcpBinding 类的新实例。
	NetTcpBinding(SecurityMode, Boolean)	用所使用的指定安全类型和一个指示是否显式启用安全会话的值来初始化 NetTcpBinding 类的新实例。

页首

属性

 

显示: 继承 保护

	名称	说明
	CloseTimeout	获取或设置在传输引发异常之前可用于关闭连接的时间间隔。 （继承自 Binding。）
	EnvelopeVersion	获取此绑定处理的消息将要使用的 SOAP 版本。
	HostNameComparisonMode	获取或设置一个值，该值指示在对 URI 进行匹配时，是否使用主机名来访问服务。
	ListenBacklog	获取或设置可挂起的最大排队连接请求数。
	MaxBufferPoolSize	获取或设置缓冲池允许的最大大小（以字节为单位），该缓冲池用于存储由绑定处理的 TCP 消息。
	MaxBufferSize	获取或设置一个值，该值指定内存中用于存储消息的缓冲区的最大大小（以字节为单位）。
	MaxConnections	获取或设置一个值，该值控制客户端上可存入池中以备后续重复使用的最大连接数，以及服务器上可挂起调度的最大连接数。
	MaxReceivedMessageSize	获取或设置绑定可处理的消息最大接收字节大小。
	MessageVersion	获取由绑定所配置的客户端和服务使用的消息版本。 （继承自 Binding。）
	Name	获取或设置绑定的名称。 （继承自 Binding。）
	Namespace	获取或设置绑定的 XML 命名空间。 （继承自 Binding。）
	OpenTimeout	获取或设置在传输引发异常之前可用于打开连接的时间间隔。 （继承自 Binding。）
	PortSharingEnabled	获取或设置一个值，该值指示是否为采用此绑定配置的连接启用 TCP 端口共享。
	ReaderQuotas	获取或设置可由配置了此绑定的终结点处理的 SOAP 消息的复杂性约束。
	ReceiveTimeout	获取或设置连接在撤消之前保持非活动状态的最大时间间隔，在此时间间隔内未接收任何应用程序消息。 （继承自 Binding。）
	ReliableSession	获取一个对象，该对象指示是否在通道终结点之间建立可靠会话。
	Scheme	返回传输的 URI 方案。 （重写 Binding.Scheme。）
	Security	获取一个对象，该对象指定与采用此绑定配置的服务一起使用的安全类型。
	SendTimeout	获取或设置在传输引发异常之前可用于完成写入操作的时间间隔。 （继承自 Binding。）
	TransactionFlow	获取或设置一个值，该值确定是否启用事务流。
	TransactionProtocol	获取或设置服务在对事务进行流处理时使用的事务处理协议。
	TransferMode	获取或设置一个值，该值指示使用此绑定配置的服务是使用消息传输的流处理模式、缓冲模式还是同时使用这两种模式。

页首

方法

 

显示: 继承 保护

	名称	说明
	BuildChannelFactory<TChannel>(BindingParameterCollection)	在客户端上生成通道工厂堆栈，此通道工厂堆栈创建具有指定类型的通道并满足绑定参数集合所指定的功能。 （继承自Binding。）
	BuildChannelFactory<TChannel>(Object[])	在客户端上生成通道工厂堆栈，该通道工厂堆栈创建具有指定类型的通道并满足对象数组所指定的功能。 （继承自Binding。）
	BuildChannelListener<TChannel>(BindingParameterCollection)	在服务上生成通道侦听器，该通道侦听器接受具有指定类型的通道并满足绑定参数集合所指定的功能。 （继承自Binding。）
	BuildChannelListener<TChannel>(Object[])	在服务上生成通道侦听器，该通道侦听器接受具有指定类型的通道并满足所指定的功能。 （继承自 Binding。）
	BuildChannelListener<TChannel>(Uri, Object[])	在服务上生成通道侦听器，该通道侦听器接受具有指定类型的通道并满足所指定的功能。 （继承自 Binding。）
	BuildChannelListener<TChannel>(Uri, BindingParameterCollection)	在服务上生成通道侦听器，该通道侦听器接受具有指定类型的通道并满足所指定的功能。 （继承自 Binding。）
	BuildChannelListener<TChannel>(Uri, String, Object[])	在服务上生成通道侦听器，该通道侦听器接受具有指定类型的通道并满足所指定的功能。 （继承自 Binding。）
	BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection)	在服务上生成通道侦听器，该通道侦听器接受具有指定类型的通道并满足所指定的功能。 （继承自 Binding。）
	BuildChannelListener<TChannel>(Uri, String, ListenUriMode,Object[])	在服务上生成通道侦听器，该通道侦听器接受具有指定类型的通道并满足所指定的功能。 （继承自 Binding。）
	BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection)	在服务上生成通道侦听器，该通道侦听器接受具有指定类型的通道并满足所指定的功能。 （继承自 Binding。）
	CanBuildChannelFactory<TChannel>(BindingParameterCollection)	返回一个值，该值指示当前绑定是否可以在客户端上生成满足指定绑定参数集合的通道工厂堆栈。 （继承自Binding。）
	CanBuildChannelFactory<TChannel>(Object[])	返回一个值，该值指示当前绑定是否可以在客户端上生成满足对象数组所指定的要求的通道工厂堆栈。 （继承自Binding。）
	CanBuildChannelListener<TChannel>(BindingParameterCollection)	返回一个值，该值指示当前绑定是否可以在服务上生成满足指定绑定参数集合的通道侦听器堆栈。 （继承自Binding。）
	CanBuildChannelListener<TChannel>(Object[])	返回一个值，该值指示当前绑定是否可以在服务上生成满足对象数组所指定的条件的通道侦听器堆栈。 （继承自Binding。）
	CreateBindingElements	为绑定创建一个绑定元素集合。 （重写Binding.CreateBindingElements()。）
	Equals(Object)	确定指定的对象是否等于当前对象。 （继承自 Object。）
	Finalize	允许对象在“垃圾回收”回收之前尝试释放资源并执行其他清理操作。 （继承自 Object。）
	GetHashCode	作为默认哈希函数。 （继承自 Object。）
	GetProperty<T>	从绑定堆栈的适当层返回所请求的类型化对象（如果存在）。 （继承自 Binding。）
	GetType	获取当前实例的 Type。 （继承自 Object。）
	MemberwiseClone	创建当前 Object 的浅表副本。 （继承自 Object。）
	ShouldSerializeListenBacklog	返回一个值，该值指示 ListenBacklog 属性是否已更改（不再是默认值）而且应进行序列化。
	ShouldSerializeMaxConnections	返回一个值，该值指示 MaxConnections 属性是否已更改（不再是默认值）而且应进行序列化。
	ShouldSerializeName	返回是否应序列化绑定名称。 （继承自 Binding。）
	ShouldSerializeNamespace	返回是否应序列化绑定命名空间。 （继承自 Binding。）
	ShouldSerializeReaderQuotas	返回一个值，该值指示 ReaderQuotas 属性是否已更改，不再是默认值且应对其进行序列化。
	ShouldSerializeReliableSession	返回一个值，该值指示 ReliableSession 属性是否已更改，不再是默认值且应对其进行序列化。
	ShouldSerializeSecurity	返回一个值，该值指示 Security 属性是否已更改，不再是默认值且应对其进行序列化。
	ShouldSerializeTransactionProtocol	返回一个值，该值指示 TransactionProtocol 属性是否已更改，不再是默认值且应对其进行序列化。
	ToString	返回表示当前对象的字符串。 （继承自 Object。）

页首

显式接口实现  

 

显示: 继承 保护

	名称	说明
	IBindingRuntimePreferences.ReceiveSynchronously	获取一个值，该值指示是同步处理传入请求还是异步处理传入请求。

页首

备注

 

默认情况下，NetTcpBinding 会生成一个运行时通信堆栈，该堆栈使用传输安全、用于消息传递的 TCP 和二进制消息编码机制。 此绑定是 Windows Communication Foundation (WCF) 系统提供的一个对应选项，用于通过 Intranet 进行通信。

NetTcpBinding 的默认配置比 WSHttpBinding 提供的配置更快，但是只适用于 WCF 到 WCF 的通信。 安全行为可通过在构造函数中使用可选的securityMode 参数进行配置。 通过使用可选的 reliableSessionEnabled 参数，可以配置 WS-ReliableMessaging 的用法。 但是在默认情况下可靠消息传递为关闭状态。 一般来说，HTTP 系统提供的绑定（如 WSHttpBinding 和 BasicHttpBinding）是默认配置为打开事项，而 NetTcpBinding 绑定是默认配置为关闭事项，因此，您必须选择性加入所需事项才能获取支持，例如获取对一种 WS-* 规范的支持。 这意味着在终结点之间交换消息方面，TCP 的默认配置比 HTTP 绑定的默认配置更快。

警告

NetTcpBinding 使用 TCP 基于服务承载的 DNS 名称的连接组合，并且服务侦听的端口号。 此适用，当客户调用不同的服务在不同的端口时服务，或在单个进程中承载它们共享端口。 如果单个客户调用承载不同的进程或者是承载的 WAS/IIS 共享端口的多项服务，客户端将会导致为 A 服务的连接) 服务 B 重用，从而引发的异常，中止的连接问题并创建的新通道。 避免此问题，使用 CustomBinding 以及客户端传达与的每个服务指定不同的 ConnectionPoolSettings.GroupName。

示例

 

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

C#

 

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

版本信息

 

.NET Framework

受以下版本支持：4.5.2、4.5.1、4.5、4、3.5、3.0

.NET Framework Client Profile

受以下版本支持：4、3.5 SP1

适用于 Windows 应用商店应用的 .NET

受以下版本支持：Windows 8

平台

 

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008（不支持服务器核心角色）, Windows Server 2008 R2（支持带 SP1 或更高版本的服务器核心角色；不支持 Itanium）

 

 

.NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表，请参阅.NET Framework 系统要求。

线程安全

 

此类型的任何公共 static（在 Visual Basic 中为 Shared） 成员都是线程安全的。但不保证所有实例成员都是线程安全的。