NetTcpBinding 类
TOC
折叠目录
展开目录
此文章由机器翻译。 将光标移到文章的句子上,以查看原文。 更多信息。
译文
原文

NetTcpBinding 类

 

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

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


public class NetTcpBinding : Binding, IBindingRuntimePreferences

名称说明
System_CAPS_pubmethodNetTcpBinding()

初始化 NetTcpBinding 类的新实例。

System_CAPS_pubmethodNetTcpBinding(SecurityMode)

用所使用的指定安全类型初始化 NetTcpBinding 类的新实例。

System_CAPS_pubmethodNetTcpBinding(SecurityMode, Boolean)

用所使用的指定安全类型和一个指示是否显式启用安全会话的值来初始化 NetTcpBinding 类的新实例。

System_CAPS_pubmethodNetTcpBinding(String)

使用指定配置名称初始化 NetTcpBinding 类的新实例。

名称说明
System_CAPS_pubpropertyCloseTimeout

获取或设置在传输引发异常之前可用于关闭连接的时间间隔。(从 Binding 继承。)

System_CAPS_pubpropertyEnvelopeVersion

获取此绑定处理的消息将要使用的 SOAP 版本。

System_CAPS_pubpropertyHostNameComparisonMode

获取或设置一个值,该值指示在对 URI 进行匹配时,是否使用主机名来访问服务。

System_CAPS_pubpropertyListenBacklog

获取或设置可挂起的最大排队连接请求数。

System_CAPS_pubpropertyMaxBufferPoolSize

获取或设置缓冲池允许的最大大小(以字节为单位),该缓冲池用于存储由绑定处理的 TCP 消息。

System_CAPS_pubpropertyMaxBufferSize

获取或设置一个值,该值指定内存中用于存储消息的缓冲区的最大大小(以字节为单位)。

System_CAPS_pubpropertyMaxConnections

获取或设置一个值,该值控制客户端上可存入池中以备后续重复使用的最大连接数,以及服务器上可挂起调度的最大连接数。

System_CAPS_pubpropertyMaxReceivedMessageSize

获取或设置绑定可处理的消息最大接收字节大小。

System_CAPS_pubpropertyMessageVersion

获取由绑定所配置的客户端和服务使用的消息版本。(从 Binding 继承。)

System_CAPS_pubpropertyName

获取或设置绑定的名称。(从 Binding 继承。)

System_CAPS_pubpropertyNamespace

获取或设置绑定的 XML 命名空间。(从 Binding 继承。)

System_CAPS_pubpropertyOpenTimeout

获取或设置在传输引发异常之前可用于打开连接的时间间隔。(从 Binding 继承。)

System_CAPS_pubpropertyPortSharingEnabled

获取或设置一个值,该值指示是否为采用此绑定配置的连接启用 TCP 端口共享。

System_CAPS_pubpropertyReaderQuotas

获取或设置可由配置了此绑定的终结点处理的 SOAP 消息的复杂性约束。

System_CAPS_pubpropertyReceiveTimeout

获取或设置连接在撤消之前保持非活动状态的最大时间间隔,在此时间间隔内未接收任何应用程序消息。(从 Binding 继承。)

System_CAPS_pubpropertyReliableSession

获取一个对象,该对象指示是否在通道终结点之间建立可靠会话。

System_CAPS_pubpropertyScheme

返回传输的 URI 方案。(替代 Binding.Scheme。)

System_CAPS_pubpropertySecurity

获取一个对象,该对象指定与采用此绑定配置的服务一起使用的安全类型。

System_CAPS_pubpropertySendTimeout

获取或设置在传输引发异常之前可用于完成写入操作的时间间隔。(从 Binding 继承。)

System_CAPS_pubpropertyTransactionFlow

获取或设置一个值,该值确定是否启用事务流。

System_CAPS_pubpropertyTransactionProtocol

获取或设置服务在对事务进行流处理时使用的事务处理协议。

System_CAPS_pubpropertyTransferMode

获取或设置一个值,该值指示使用此绑定配置的服务是使用消息传输的流处理模式、缓冲模式还是同时使用这两种模式。

名称说明
System_CAPS_pubmethodBuildChannelFactory<TChannel>(BindingParameterCollection)

在客户端上生成通道工厂堆栈,此通道工厂堆栈创建具有指定类型的通道并满足绑定参数集合所指定的功能。(从 Binding 继承。)

System_CAPS_pubmethodBuildChannelFactory<TChannel>(Object[])

在客户端上生成通道工厂堆栈,该通道工厂堆栈创建具有指定类型的通道并满足对象数组所指定的功能。(从 Binding 继承。)

System_CAPS_pubmethodBuildChannelListener<TChannel>(BindingParameterCollection)

在服务上生成通道侦听器,该通道侦听器接受具有指定类型的通道并满足绑定参数集合所指定的功能。(从 Binding 继承。)

System_CAPS_pubmethodBuildChannelListener<TChannel>(Object[])

在服务上生成通道侦听器,该通道侦听器接受具有指定类型的通道并满足所指定的功能。(从 Binding 继承。)

System_CAPS_pubmethodBuildChannelListener<TChannel>(Uri, BindingParameterCollection)

在服务上生成通道侦听器,该通道侦听器接受具有指定类型的通道并满足所指定的功能。(从 Binding 继承。)

System_CAPS_pubmethodBuildChannelListener<TChannel>(Uri, Object[])

在服务上生成通道侦听器,该通道侦听器接受具有指定类型的通道并满足所指定的功能。(从 Binding 继承。)

System_CAPS_pubmethodBuildChannelListener<TChannel>(Uri, String, BindingParameterCollection)

在服务上生成通道侦听器,该通道侦听器接受具有指定类型的通道并满足所指定的功能。(从 Binding 继承。)

System_CAPS_pubmethodBuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection)

在服务上生成通道侦听器,该通道侦听器接受具有指定类型的通道并满足所指定的功能。(从 Binding 继承。)

System_CAPS_pubmethodBuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[])

在服务上生成通道侦听器,该通道侦听器接受具有指定类型的通道并满足所指定的功能。(从 Binding 继承。)

System_CAPS_pubmethodBuildChannelListener<TChannel>(Uri, String, Object[])

在服务上生成通道侦听器,该通道侦听器接受具有指定类型的通道并满足所指定的功能。(从 Binding 继承。)

System_CAPS_pubmethodCanBuildChannelFactory<TChannel>(BindingParameterCollection)

返回一个值,该值指示当前绑定是否可以在客户端上生成满足指定绑定参数集合的通道工厂堆栈。(从 Binding 继承。)

System_CAPS_pubmethodCanBuildChannelFactory<TChannel>(Object[])

返回一个值,该值指示当前绑定是否可以在客户端上生成满足对象数组所指定的要求的通道工厂堆栈。(从 Binding 继承。)

System_CAPS_pubmethodCanBuildChannelListener<TChannel>(BindingParameterCollection)

返回一个值,该值指示当前绑定是否可以在服务上生成满足指定绑定参数集合的通道侦听器堆栈。(从 Binding 继承。)

System_CAPS_pubmethodCanBuildChannelListener<TChannel>(Object[])

返回一个值,该值指示当前绑定是否可以在服务上生成满足对象数组所指定的条件的通道侦听器堆栈。(从 Binding 继承。)

System_CAPS_pubmethodCreateBindingElements()

为绑定创建一个绑定元素集合。(替代 Binding.CreateBindingElements()。)

System_CAPS_pubmethodEquals(Object)

确定指定的对象是否等于当前对象。(从 Object 继承。)

System_CAPS_protmethodFinalize()

在垃圾回收将某一对象回收前允许该对象尝试释放资源并执行其他清理操作。(从 Object 继承。)

System_CAPS_pubmethodGetHashCode()

作为默认哈希函数。(从 Object 继承。)

System_CAPS_pubmethodGetProperty<T>(BindingParameterCollection)

从绑定堆栈的适当层返回所请求的类型化对象(如果存在)。(从 Binding 继承。)

System_CAPS_pubmethodGetType()

获取当前实例的 Type(从 Object 继承。)

System_CAPS_protmethodMemberwiseClone()

创建当前 Object 的浅表副本。(从 Object 继承。)

System_CAPS_pubmethodShouldSerializeListenBacklog()

返回一个值,该值指示 ListenBacklog 属性是否已更改(不再是默认值)而且应进行序列化。

System_CAPS_pubmethodShouldSerializeMaxConnections()

返回一个值,该值指示 MaxConnections 属性是否已更改(不再是默认值)而且应进行序列化。

System_CAPS_pubmethodShouldSerializeName()

返回是否应序列化绑定名称。(从 Binding 继承。)

System_CAPS_pubmethodShouldSerializeNamespace()

返回是否应序列化绑定命名空间。(从 Binding 继承。)

System_CAPS_pubmethodShouldSerializeReaderQuotas()

返回一个值,该值指示 ReaderQuotas 属性是否已更改,不再是默认值且应对其进行序列化。

System_CAPS_pubmethodShouldSerializeReliableSession()

返回一个值,该值指示 ReliableSession 属性是否已更改,不再是默认值且应对其进行序列化。

System_CAPS_pubmethodShouldSerializeSecurity()

返回一个值,该值指示 Security 属性是否已更改,不再是默认值且应对其进行序列化。

System_CAPS_pubmethodShouldSerializeTransactionProtocol()

返回一个值,该值指示 TransactionProtocol 属性是否已更改,不再是默认值且应对其进行序列化。

System_CAPS_pubmethodToString()

返回表示当前对象的字符串。(从 Object 继承。)

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

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

System_CAPS_warning警告

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

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

Snippet section 1 of code snippet {"project_id":"3fedad16-eaf1-41a6-8f96-0c1949c68f32","entity_id":"6edd990b-cb33-4e76-94b4-3370f1145ea4","entity_type":"CodeSnippet","locale":"en-US"} in source file ({"filename":"/cs/source.cs","blob_type":"Source","blob_id":"-002fcs-002fsource-002ecs","blob_revision":3}) overlaps with other snippet sections. Ensure the tags are placed correctly.

Universal Windows Platform
4.5 后可用
.NET Framework
3.0 后可用
Portable Class Library
受以下版本支持:portable .NET platforms

此类型的任何公共静态(Visual Basic 中为 Shared)成员都是线程安全的。但不保证所有实例成员都是线程安全的。

返回页首
显示:
© 2016 Microsoft