NetHttpBinding 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
指定 . NetHttpBinding的设置。
public ref class NetHttpBinding : System::ServiceModel::HttpBindingBase
public class NetHttpBinding : System.ServiceModel.HttpBindingBase
type NetHttpBinding = class
inherit HttpBindingBase
Public Class NetHttpBinding
Inherits HttpBindingBase
- 继承
注解
NetHttpBinding 是一个绑定,旨在使用 HTTP 或 WebSocket 服务,默认情况下使用二进制编码。 注意:仅Windows 8支持 WebSocket。 NetHttpBinding将检测它是否与请求-答复协定或双工协定一起使用,并更改其行为以匹配 - 它将使用 HTTP 进行请求-答复和 WebSocket 进行双工(仅在Windows 8上)。 通过将属性设置为 WebSocketTransportUsage 以下值之一,可以重写此行为:
WhenDuplex - 这是默认值,其行为如下所述。
从不 - 这可以防止使用 WebSocket。 尝试使用具有此设置的双工协定将导致异常。
始终 - 这强制使用 WebSocket,甚至用于请求-答复协定。
NetHttpBinding 支持 HTTP 模式和 WebSocket 模式下的可靠会话。 在 WebSocket 模式下,会话是由传输层提供的。
构造函数
| 名称 | 说明 |
|---|---|
| NetHttpBinding() |
初始化 NetHttpBinding 类的新实例。 |
| NetHttpBinding(BasicHttpSecurityMode, Boolean) |
使用指定的安全模式初始化类的新实例 NetHttpBinding 。 |
| NetHttpBinding(BasicHttpSecurityMode) |
使用指定的安全模式初始化类的新实例 NetHttpBinding 。 |
| NetHttpBinding(String) |
使用指定的配置名称初始化类的新实例 NetHttpBinding 。 |
属性
| 名称 | 说明 |
|---|---|
| AllowCookies |
获取或设置一个值,该值指示客户端是否接受 Cookie 并在将来的请求上传播 Cookie。 (继承自 HttpBindingBase) |
| BypassProxyOnLocal |
获取或设置一个值,该值指示是否绕过本地地址的代理服务器。 (继承自 HttpBindingBase) |
| CloseTimeout |
获取或设置在传输引发异常之前连接要关闭的时间间隔。 (继承自 Binding) |
| EnvelopeVersion |
获取用于此绑定处理的消息的 SOAP 版本。 (继承自 HttpBindingBase) |
| HostNameComparisonMode |
获取或设置一个值,该值指示主机名在匹配 URI 时是否用于访问服务。 (继承自 HttpBindingBase) |
| MaxBufferPoolSize |
获取或设置从通道接收消息的消息缓冲区的管理器分配的最大内存量(以字节为单位)。 (继承自 HttpBindingBase) |
| MaxBufferSize |
获取或设置从通道接收消息的缓冲区的最大大小(以字节为单位)。 (继承自 HttpBindingBase) |
| MaxReceivedMessageSize |
获取或设置可在配置此绑定的通道上接收的消息的最大大小(以字节为单位)。 (继承自 HttpBindingBase) |
| MessageEncoding |
获取或设置用于对消息进行编码的消息编码的类型。 |
| MessageVersion |
获取使用绑定配置的客户端和服务使用的消息版本。 (继承自 Binding) |
| Name |
获取或设置绑定的名称。 (继承自 Binding) |
| Namespace |
获取或设置绑定的 XML 命名空间。 (继承自 Binding) |
| OpenTimeout |
获取或设置在传输引发异常之前为连接打开提供的时间间隔。 (继承自 Binding) |
| ProxyAddress |
获取或设置 HTTP 代理的 URI 地址。 (继承自 HttpBindingBase) |
| ReaderQuotas |
获取或设置 SOAP 消息的复杂性的约束,这些消息可由配置有此绑定的终结点处理。 (继承自 HttpBindingBase) |
| ReceiveTimeout |
获取或设置连接在删除之前连接可以保持非活动状态的时间间隔,在此期间不会收到任何应用程序消息。 (继承自 Binding) |
| ReliableSession |
获取或设置一个对象,该对象指示是否在通道终结点之间建立可靠会话。 |
| Scheme |
获取使用此绑定配置的通道和侦听器的 URI 传输方案。 (继承自 HttpBindingBase) |
| Security |
获取或设置与配置绑定的服务一起使用的安全性。 |
| SendTimeout |
获取或设置传输引发异常之前为写入操作完成提供的时间间隔。 (继承自 Binding) |
| TextEncoding |
获取或设置用于消息文本的字符编码。 (继承自 HttpBindingBase) |
| TransferMode |
获取或设置一个值,该值指示消息是发送缓冲还是流式传输。 (继承自 HttpBindingBase) |
| UseDefaultWebProxy |
获取或设置一个值,该值指示是否应使用系统自动配置的 HTTP 代理(如果可用)。 (继承自 HttpBindingBase) |
| WebSocketSettings |
获取 websocket 的设置。 |
方法
显式接口实现
| 名称 | 说明 |
|---|---|
| IBindingRuntimePreferences.ReceiveSynchronously |
获取一个值,该值指示是同步还是异步处理传入请求。 (继承自 HttpBindingBase) |