此页面有用吗?
您对此内容的反馈非常重要。 请告诉我们您的想法。
更多反馈?
1500 个剩余字符
NetTcpBinding 类
Collapse the table of content
Expand the table of content
此文章由机器翻译。 将光标移到文章的句子上,以查看原文。 更多信息。
译文
原文

NetTcpBinding 类

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

命名空间:  System.ServiceModel
程序集:  System.ServiceModel(在 System.ServiceModel.dll 中)

public class NetTcpBinding : Binding, 
	IBindingRuntimePreferences

NetTcpBinding 类型公开以下成员。

  名称说明
公共方法受 适用于 Windows 应用商店应用的 .NET 支持NetTcpBinding()初始化 NetTcpBinding 类的新实例。
公共方法受 适用于 Windows 应用商店应用的 .NET 支持NetTcpBinding(SecurityMode)用所使用的指定安全类型初始化 NetTcpBinding 类的新实例。
公共方法受 适用于 Windows 应用商店应用的 .NET 支持NetTcpBinding(String)使用指定配置名称初始化 NetTcpBinding 类的新实例。
公共方法NetTcpBinding(SecurityMode, Boolean)用所使用的指定安全类型和一个指示是否显式启用安全会话的值来初始化 NetTcpBinding 类的新实例。
页首

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

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

  名称说明
显式接口实现私有属性IBindingRuntimePreferences.ReceiveSynchronously获取一个值,该值指示是同步处理传入请求还是异步处理传入请求。
页首

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

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

警告说明警告

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

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


	    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) 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

社区附加资源

添加
显示:
© 2015 Microsoft