WSDualHttpBinding WSDualHttpBinding WSDualHttpBinding WSDualHttpBinding Class

定义

一个安全且可互操作的绑定,可用于双工服务协定,允许服务和客户端发送和接收消息。A secure and interoperable binding that is designed for use with duplex service contracts that allows both services and clients to send and receive messages.

public ref class WSDualHttpBinding : System::ServiceModel::Channels::Binding, System::ServiceModel::Channels::IBindingRuntimePreferences
public class WSDualHttpBinding : System.ServiceModel.Channels.Binding, System.ServiceModel.Channels.IBindingRuntimePreferences
type WSDualHttpBinding = class
    inherit Binding
    interface IBindingRuntimePreferences
Public Class WSDualHttpBinding
Inherits Binding
Implements IBindingRuntimePreferences
继承
WSDualHttpBindingWSDualHttpBindingWSDualHttpBindingWSDualHttpBinding
实现

示例

下面的示例演示如何在配置文件中指定 wsDualHttpBinding 绑定。The following example shows how to specify the wsDualHttpBinding binding in a configuration file.

<client>
  <endpoint 
    name ="ServerEndpoint" 
    address="http://localhost:12000/DuplexUsingConfig/Server"
    bindingConfiguration="WSDualHttpBinding_IDuplex" 
    binding="wsDualHttpBinding"
    contract="IDuplex" 
/>
</client>
<bindings>
  <wsDualHttpBinding>
    <binding 
      name="WSDualHttpBinding_IDuplex"  
      clientBaseAddress="http://localhost:8000/myClient/" 
    />
  </wsDualHttpBinding>
</bindings>

注解

WSDualHttpBinding 提供与 WSHttpBinding 相同的 Web 服务协议支持,但用于双工协定。The WSDualHttpBinding provides the same support for Web Service protocols as the WSHttpBinding, but for use with duplex contracts. WSDualHttpBinding 仅支持 SOAP 安全,且需要可靠的消息传递。WSDualHttpBinding only supports SOAP security and requires reliable messaging. 此绑定要求客户端具有可为服务提供回调终结点的公共 URI。This binding requires that the client has a public URI that provides a callback endpoint for the service. 这由 ClientBaseAddress 提供。This is provided by the ClientBaseAddress. 双向绑定向服务公开客户端的 IP 地址。A dual binding exposes the IP address of the client to the service. 客户端应使用安全来确保仅连接到自己信任的服务。The client should use security to ensure that it only connects to services it trusts.

默认情况下,WSDualHttpBinding 将生成以下绑定元素堆栈:By default the WSDualHttpBinding generates the following binding element stack:

构造函数

WSDualHttpBinding() WSDualHttpBinding() WSDualHttpBinding() WSDualHttpBinding()

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

WSDualHttpBinding(String) WSDualHttpBinding(String) WSDualHttpBinding(String) WSDualHttpBinding(String)

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

WSDualHttpBinding(WSDualHttpSecurityMode) WSDualHttpBinding(WSDualHttpSecurityMode) WSDualHttpBinding(WSDualHttpSecurityMode) WSDualHttpBinding(WSDualHttpSecurityMode)

通过绑定所使用的指定安全性类型初始化 WSDualHttpBinding 类的新实例。Initializes a new instance of the WSDualHttpBinding class with a specified type of security used by the binding.

属性

BypassProxyOnLocal BypassProxyOnLocal BypassProxyOnLocal BypassProxyOnLocal

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

ClientBaseAddress ClientBaseAddress ClientBaseAddress ClientBaseAddress

获取或设置客户端的基址。Gets or sets the base address of the client.

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.

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.

MaxBufferPoolSize MaxBufferPoolSize MaxBufferPoolSize MaxBufferPoolSize

获取或设置可为消息缓冲区管理器(该管理器在采用此绑定配置的终结点接收消息)分配的最大内存量(以字节为单位)。Gets or sets the maximum amount of memory, in bytes, that can be allocated for the manager of message buffers that receive messages at the endpoints configured with this binding.

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.

MessageEncoding MessageEncoding MessageEncoding MessageEncoding

获取或设置一个值,该值指示是使用 MTOM 还是文本/XML 对 SOAP 消息进行编码。Gets or sets whether MTOM or Text/XML is used to encode SOAP messages.

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.

ReaderQuotas ReaderQuotas ReaderQuotas ReaderQuotas

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

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 an object that provides convenient access to the properties of a reliable session binding element that are available when using one of the system-provided bindings.

Scheme Scheme Scheme Scheme

获取用此绑定配置的通道和侦听器的 URI 传输方案。Gets the URI transport scheme for the channels and listeners that are configured with this binding.

Security Security Security Security

获取一个对象,该对象指定与此绑定一起使用的安全设置。Gets an object that specifies the security settings used with this 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.

TransactionFlow TransactionFlow TransactionFlow TransactionFlow

获取或设置一个值,该值指示此绑定是否应支持流动 WS-Transactions。Gets or sets a value that indicates whether this binding should support flowing WS-Transactions.

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.

方法

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.

(Inherited from Binding)
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()

返回一个包含在当前绑定中的已排序的绑定元素集合。Returns an ordered collection of binding elements contained in the current 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()

返回一个值,该值指示 ReaderQuotas 属性是否已更改,不再是默认值且应对其进行序列化。Returns a value that indicates whether the ReaderQuotas property has changed from its default value and should be serialized.

ShouldSerializeReliableSession() ShouldSerializeReliableSession() ShouldSerializeReliableSession() ShouldSerializeReliableSession()

返回一个值,该值指示 ReliableSession 属性是否已更改,不再是默认值且应对其进行序列化。Returns a value that indicates whether the ReliableSession property has changed from its default value and should be serialized.

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

返回一个值,该值指示 Security 属性是否已更改,不再是默认值且应对其进行序列化。Returns a value that indicates whether the Security property has changed from its default value and should be serialized.

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

返回一个值,该值指示 TextEncoding 属性是否已更改,不再是默认值且应对其进行序列化。Returns a value that indicates whether the TextEncoding property has changed from its default value and should be serialized.

ToString() ToString() ToString() ToString()

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

(Inherited from Object)

显式界面实现

IBindingRuntimePreferences.ReceiveSynchronously IBindingRuntimePreferences.ReceiveSynchronously IBindingRuntimePreferences.ReceiveSynchronously IBindingRuntimePreferences.ReceiveSynchronously

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

适用于