NetHttpBinding NetHttpBinding NetHttpBinding NetHttpBinding Class

定义

指定 NetHttpBinding 的设置。Specifies settings for 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 服务设计的绑定,默认情况下使用二进制编码。NetHttpBinding is a binding designed for consuming HTTP or WebSocket services and uses binary encoding by default. 注意:在 Windows 8 上仅支持 Websocket。Note: WebSockets are only supported on Windows 8. NetHttpBinding 将检测它是否与请求-答复协定或双工协定一起使用,并更改其行为以进行匹配-它将使用 HTTP 请求-答复和 Websocket 为双工模式 (仅在 Windows 8) 上。NetHttpBinding will detect whether it is used with a request-reply contract or duplex contract and change its behavior to match - it will use HTTP for request-reply and WebSockets for duplex (only on Windows 8). 可以通过设置重写此行为WebSocketTransportUsage属性设置为以下值之一:This behavior can be overridden by setting the WebSocketTransportUsage property to one of the following values:

  1. 双工时-这是默认值,如上文所述的行为。WhenDuplex- This is the default value and behaves as described above.

  2. 从不 - 阻止使用 WebSocket。Never - This prevents WebSockets from being used. 尝试使用具有此设置的双工协定将导致异常。Attempting to use a duplex contract with this setting will result in an exception.

  3. 始终 - 甚至对于请求-答复协定,也会强制使用 WebSocket。Always - This forces WebSockets to be used even for request-reply contracts.

NetHttpBinding 支持 HTTP 模式和 WebSocket 模式下的可靠会话。NetHttpBinding supports reliable sessions in both HTTP mode and WebSocket mode. 在 WebSocket 模式下,会话由传输来提供。In WebSocket mode sessions are provided by the transport.

构造函数

NetHttpBinding() NetHttpBinding() NetHttpBinding() NetHttpBinding()

初始化 NetHttpBinding 类的新实例。Initializes a new instance of the NetHttpBinding class.

NetHttpBinding(BasicHttpSecurityMode) NetHttpBinding(BasicHttpSecurityMode) NetHttpBinding(BasicHttpSecurityMode) NetHttpBinding(BasicHttpSecurityMode)

使用指定的安全模式初始化 NetHttpBinding 类的新实例。Initializes a new instance of the NetHttpBinding class with the specified security mode.

NetHttpBinding(BasicHttpSecurityMode, Boolean) NetHttpBinding(BasicHttpSecurityMode, Boolean) NetHttpBinding(BasicHttpSecurityMode, Boolean) NetHttpBinding(BasicHttpSecurityMode, Boolean)

使用指定的安全模式初始化 NetHttpBinding 类的新实例。Initializes a new instance of the NetHttpBinding class with the specified security mode.

NetHttpBinding(String) NetHttpBinding(String) NetHttpBinding(String) NetHttpBinding(String)

使用指定的配置名称初始化 NetHttpBinding 类的新实例。Initializes a new instance of the NetHttpBinding class with the specified configuration name.

属性

AllowCookies AllowCookies AllowCookies AllowCookies

获取或设置一个值,该值指示客户端是否接受 Cookie 并根据今后的请求传播 Cookie。Gets or sets a value that indicates whether the client accepts cookies and propagates them on future requests.

(Inherited from HttpBindingBase)
BypassProxyOnLocal BypassProxyOnLocal BypassProxyOnLocal BypassProxyOnLocal

获取或设置一个值,该值指示是否对本地地址不使用代理服务器。Gets or sets a value that indicates whether to bypass the proxy server for local addresses.

(Inherited from HttpBindingBase)
CloseTimeout CloseTimeout CloseTimeout CloseTimeout

获取或设置在传输引发异常之前可用于关闭连接的时间间隔。Gets or sets the interval of time provided for a connection to close before the transport raises an exception.

(Inherited from Binding)
EnvelopeVersion EnvelopeVersion EnvelopeVersion EnvelopeVersion

获取此绑定处理的消息将要使用的 SOAP 版本。Gets the version of SOAP that is used for messages that are processed by this binding.

(Inherited from HttpBindingBase)
HostNameComparisonMode HostNameComparisonMode HostNameComparisonMode HostNameComparisonMode

获取或设置一个值,该值指示在对 URI 进行匹配时,是否使用主机名来访问服务。Gets or sets a value that indicates whether the hostname is used to reach the service when matching the URI.

(Inherited from HttpBindingBase)
IBindingRuntimePreferences.ReceiveSynchronously IBindingRuntimePreferences.ReceiveSynchronously IBindingRuntimePreferences.ReceiveSynchronously IBindingRuntimePreferences.ReceiveSynchronously

获取一个值,该值指示是同步处理传入请求还是异步处理传入请求。Gets a value that indicates whether incoming requests are handled synchronously or asynchronously.

(Inherited from HttpBindingBase)
MaxBufferPoolSize MaxBufferPoolSize MaxBufferPoolSize MaxBufferPoolSize

获取或设置为从通道接收消息的消息缓冲区管理器分配并供其使用的最大内存量(以字节为单位)。Gets or sets the maximum amount of memory, in bytes, that is allocated for use by the manager of the message buffers that receive messages from the channel.

(Inherited from HttpBindingBase)
MaxBufferSize MaxBufferSize MaxBufferSize MaxBufferSize

获取或设置缓冲区的最大大小(以字节为单位),该缓冲区用于接收来自通道的消息。Gets or sets the maximum size, in bytes, for a buffer that receives messages from the channel.

(Inherited from HttpBindingBase)
MaxReceivedMessageSize MaxReceivedMessageSize MaxReceivedMessageSize MaxReceivedMessageSize

获取或设置配置了此绑定配置的通道上可以接收的消息的最大大小(以字节为单位)。Gets or sets the maximum size, in bytes, for a message that can be received on a channel configured with this binding.

(Inherited from HttpBindingBase)
MessageEncoding MessageEncoding MessageEncoding MessageEncoding

获取或设置用于编码消息的消息编码类型。Gets or sets the type of the message encoding that is used to encode the message.

MessageVersion MessageVersion MessageVersion MessageVersion

获取由绑定所配置的客户端和服务使用的消息版本。Gets the message version used by clients and services configured with the binding.

(Inherited from Binding)
Name Name Name Name

获取或设置绑定的名称。Gets or sets the name of the binding.

(Inherited from Binding)
Namespace Namespace Namespace Namespace

获取或设置绑定的 XML 命名空间。Gets or sets the XML namespace of the binding.

(Inherited from Binding)
OpenTimeout OpenTimeout OpenTimeout OpenTimeout

获取或设置在传输引发异常之前可用于打开连接的时间间隔。Gets or sets the interval of time provided for a connection to open before the transport raises an exception.

(Inherited from Binding)
ProxyAddress ProxyAddress ProxyAddress ProxyAddress

获取或设置 HTTP 代理的 URI 地址。Gets or sets the URI address of the HTTP proxy.

(Inherited from HttpBindingBase)
ReaderQuotas ReaderQuotas ReaderQuotas ReaderQuotas

获取或设置可由配置了此绑定的终结点处理的 SOAP 消息的该复杂性约束。Gets or sets the constraints on the complexity of SOAP messages that can be processed by endpoints configured with this binding.

(Inherited from HttpBindingBase)
ReceiveTimeout ReceiveTimeout ReceiveTimeout ReceiveTimeout

获取或设置连接在撤消之前保持非活动状态的最大时间间隔,在此时间间隔内未接收任何应用程序消息。Gets or sets the interval of time that a connection can remain inactive, during which no application messages are received, before it is dropped.

(Inherited from Binding)
ReliableSession ReliableSession ReliableSession ReliableSession

获取或设置一个对象,该对象指示是否在通道终结点之间建立可靠会话。Gets or sets an object that indicates whether a reliable session is established between channel endpoints.

Scheme Scheme Scheme Scheme
Security Security Security Security

获取或设置用于配置有绑定的服务的安全。Gets or sets the security used with services configured with the binding.

SendTimeout SendTimeout SendTimeout SendTimeout

获取或设置在传输引发异常之前可用于完成写入操作的时间间隔。Gets or sets the interval of time provided for a write operation to complete before the transport raises an exception.

(Inherited from Binding)
TextEncoding TextEncoding TextEncoding TextEncoding

获取或设置用于消息文本的字符编码。Gets or sets the character encoding that is used for the message text.

(Inherited from HttpBindingBase)
TransferMode TransferMode TransferMode TransferMode

获取或设置一个值,该值指示是通过缓冲处理还是流处理来发送消息。Gets or sets a value that indicates whether messages are sent buffered or streamed.

(Inherited from HttpBindingBase)
UseDefaultWebProxy UseDefaultWebProxy UseDefaultWebProxy UseDefaultWebProxy

获取或设置一个值,该值指示是否应使用系统的自动配置 HTTP 代理(如果可用)。Gets or sets a value that indicates whether the auto-configured HTTP proxy of the system should be used, if available.

(Inherited from HttpBindingBase)
WebSocketSettings WebSocketSettings WebSocketSettings WebSocketSettings

获取 websocket 的设置。Gets the settings of the websocket.

方法

BuildChannelFactory<TChannel>(BindingParameterCollection) BuildChannelFactory<TChannel>(BindingParameterCollection) BuildChannelFactory<TChannel>(BindingParameterCollection) BuildChannelFactory<TChannel>(BindingParameterCollection)

在客户端上生成通道工厂堆栈,此通道工厂堆栈创建具有指定类型的通道并满足绑定参数集合所指定的功能。Builds the channel factory stack on the client that creates a specified type of channel and that satisfies the features specified by a collection of binding parameters.

BuildChannelFactory<TChannel>(Object[]) BuildChannelFactory<TChannel>(Object[]) BuildChannelFactory<TChannel>(Object[]) BuildChannelFactory<TChannel>(Object[])

在客户端上生成通道工厂堆栈,该通道工厂堆栈创建具有指定类型的通道并满足对象数组所指定的功能。Builds the channel factory stack on the client that creates a specified type of channel and that satisfies the features specified by an object array.

(Inherited from Binding)
BuildChannelListener<TChannel>(BindingParameterCollection) BuildChannelListener<TChannel>(BindingParameterCollection) BuildChannelListener<TChannel>(BindingParameterCollection) BuildChannelListener<TChannel>(BindingParameterCollection)

在服务上生成通道侦听器,该通道侦听器接受具有指定类型的通道并满足绑定参数集合所指定的功能。Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified by a collection of binding parameters.

(Inherited from Binding)
BuildChannelListener<TChannel>(Object[]) BuildChannelListener<TChannel>(Object[]) BuildChannelListener<TChannel>(Object[]) BuildChannelListener<TChannel>(Object[])

在服务上生成通道侦听器,该通道侦听器接受具有指定类型的通道并满足所指定的功能。Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
BuildChannelListener<TChannel>(Uri, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, BindingParameterCollection)

在服务上生成通道侦听器,该通道侦听器接受具有指定类型的通道并满足所指定的功能。Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
BuildChannelListener<TChannel>(Uri, Object[]) BuildChannelListener<TChannel>(Uri, Object[]) BuildChannelListener<TChannel>(Uri, Object[]) BuildChannelListener<TChannel>(Uri, Object[])

在服务上生成通道侦听器,该通道侦听器接受具有指定类型的通道并满足所指定的功能。Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection)

在服务上生成通道侦听器,该通道侦听器接受具有指定类型的通道并满足所指定的功能。Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection)

在服务上生成通道侦听器,该通道侦听器接受具有指定类型的通道并满足所指定的功能。Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[]) BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[]) BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[]) BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[])

在服务上生成通道侦听器,该通道侦听器接受具有指定类型的通道并满足所指定的功能。Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
BuildChannelListener<TChannel>(Uri, String, Object[]) BuildChannelListener<TChannel>(Uri, String, Object[]) BuildChannelListener<TChannel>(Uri, String, Object[]) BuildChannelListener<TChannel>(Uri, String, Object[])

在服务上生成通道侦听器,该通道侦听器接受具有指定类型的通道并满足所指定的功能。Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
CanBuildChannelFactory<TChannel>(BindingParameterCollection) CanBuildChannelFactory<TChannel>(BindingParameterCollection) CanBuildChannelFactory<TChannel>(BindingParameterCollection) CanBuildChannelFactory<TChannel>(BindingParameterCollection)

返回一个值,该值指示当前绑定是否可以在客户端上生成满足指定绑定参数集合的通道工厂堆栈。Returns a value that indicates whether the current binding can build a channel factory stack on the client that satisfies the collection of binding parameters specified.

(Inherited from Binding)
CanBuildChannelFactory<TChannel>(Object[]) CanBuildChannelFactory<TChannel>(Object[]) CanBuildChannelFactory<TChannel>(Object[]) CanBuildChannelFactory<TChannel>(Object[])

返回一个值,该值指示当前绑定是否可以在客户端上生成满足对象数组所指定的需求的通道工厂堆栈。Returns a value that indicates whether the current binding can build a channel factory stack on the client that satisfies the requirements specified by an object array.

(Inherited from Binding)
CanBuildChannelListener<TChannel>(BindingParameterCollection) CanBuildChannelListener<TChannel>(BindingParameterCollection) CanBuildChannelListener<TChannel>(BindingParameterCollection) CanBuildChannelListener<TChannel>(BindingParameterCollection)

返回一个值,该值指示当前绑定是否可以在服务上生成满足指定绑定参数集合的通道侦听器堆栈。Returns a value that indicates whether the current binding can build a channel listener stack on the service that satisfies the collection of binding parameters specified.

(Inherited from Binding)
CanBuildChannelListener<TChannel>(Object[]) CanBuildChannelListener<TChannel>(Object[]) CanBuildChannelListener<TChannel>(Object[]) CanBuildChannelListener<TChannel>(Object[])

返回一个值,该值指示当前绑定是否可以在服务上生成满足对象数组所指定的条件的通道侦听器堆栈。Returns a value that indicates whether the current binding can build a channel listener stack on the service that satisfies the criteria specified in an array of objects.

(Inherited from Binding)
CreateBindingElements() CreateBindingElements() CreateBindingElements() CreateBindingElements()

为绑定创建一个包含绑定元素的集合。Creates a collection that contains the binding elements for the binding.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

确定指定的对象是否等于当前对象。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

作为默认哈希函数。Serves as the default hash function.

(Inherited from Object)
GetProperty<T>(BindingParameterCollection) GetProperty<T>(BindingParameterCollection) GetProperty<T>(BindingParameterCollection) GetProperty<T>(BindingParameterCollection)

从绑定堆栈的适当层返回所请求的类型化对象(如果存在)。Returns a typed object requested, if present, from the appropriate layer in the binding stack.

(Inherited from Binding)
GetType() GetType() GetType() GetType()

获取当前实例的 TypeGets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

创建当前 Object 的浅表副本。Creates a shallow copy of the current Object.

(Inherited from Object)
ShouldSerializeName() ShouldSerializeName() ShouldSerializeName() ShouldSerializeName()

返回是否应序列化绑定名称。Returns whether the name of the binding should be serialized.

(Inherited from Binding)
ShouldSerializeNamespace() ShouldSerializeNamespace() ShouldSerializeNamespace() ShouldSerializeNamespace()

返回是否应序列化绑定命名空间。Returns whether the namespace of the binding should be serialized.

(Inherited from Binding)
ShouldSerializeReaderQuotas() ShouldSerializeReaderQuotas() ShouldSerializeReaderQuotas() ShouldSerializeReaderQuotas()

返回是否应序列化对 SOAP 消息结构的复杂性施加的约束值。Returns whether the constraint values placed on the complexity of SOAP message structure should be serialized.

(Inherited from HttpBindingBase)
ShouldSerializeReliableSession() ShouldSerializeReliableSession() ShouldSerializeReliableSession() ShouldSerializeReliableSession()

指示可靠会话是否已更改,不再是默认值且应对其进行序列化。Indicates whether the reliable session has changed from its default value and should be serialized.

ShouldSerializeSecurity() ShouldSerializeSecurity() ShouldSerializeSecurity() ShouldSerializeSecurity()

指示安全性是否已从默认值中更改或是否应被序列化。Indicates whether the security has changed from its default value and should be serialized.

ShouldSerializeTextEncoding() ShouldSerializeTextEncoding() ShouldSerializeTextEncoding() ShouldSerializeTextEncoding()

返回是否应对文本编码设置进行序列化。Returns whether settings for text encoding should be serialized.

(Inherited from HttpBindingBase)
ToString() ToString() ToString() ToString()

返回表示当前对象的字符串。Returns a string that represents the current object.

(Inherited from Object)

适用于