双方向サービス コントラクト、または SOAP 中継局を介しての通信に適した、セキュリティで保護されて信頼できる相互操作可能なバインディングを定義します。Defines a secure, reliable and interoperable binding that is suitable for duplex service contracts or communication through SOAP intermediaries.



        <binding name="string"  

        <reliableSession ordered="Boolean"  
            inactivityTimeout="TimeSpan" />  
        <security mode="None/Message">  
           <message clientCredentialType="None/Windows/UserName/Certificate/CardSpace"  
                    algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15" />  
       <readerQuotas             maxArrayLength="Integer"            maxBytesPerRead="Integer"            maxDepth="Integer"             maxNameTableCharCount="Integer"                     maxStringContentLength="Integer" />    </binding>  

属性および要素Attributes and Elements

以降のセクションでは、属性、子要素、および親要素について説明します。The following sections describe attributes, child elements, and parent elements


属性Attribute 説明Description
bypassProxyOnLocalbypassProxyOnLocal ローカル アドレスでプロキシ サーバーをバイパスするかどうかを示すブール値。A Boolean value that indicates whether to bypass the proxy server for local addresses. 既定値は、false です。The default is false.
clientBaseAddressclientBaseAddress サービスからの応答メッセージをクライアントがリッスンするベース アドレスを設定する URI。A URI that sets the base address that the client listens to for response messages from the service. 指定されている場合は、このアドレス (およびチャネルごとの GUID) がリッスンに使用されます。If specified, this address (plus a per-channelGUID) is used for listening. 値が指定されていない場合は、クライアント ベース アドレスは、トランスポートに固有の方法で生成されます。If the value is not specified, the client base address is generated in a transport-specific manner. 既定値は、null です。The default is null.
closeTimeoutcloseTimeout クローズ操作が完了するまでの期間を指定する TimeSpan 値。A TimeSpan value that specifies the interval of time provided for a close operation to complete. この値は必ず Zero 以上である必要があります。This value should be greater than or equal to Zero. 既定値は 00:01:00 です。The default is 00:01:00.
hostnameComparisonModehostnameComparisonMode URI の解析に使用する HTTP ホスト名比較モードを指定します。Specifies the HTTP hostname comparison mode used to parse URIs. この属性は HostNameComparisonMode 型で、URI が一致したときにサービスへのアクセスにホスト名を使用するかどうかを指定します。This attribute is of type HostNameComparisonMode, which indicates whether the hostname is used to reach the service when matching on the URI. 既定値は StrongWildcard で、一致しているホスト名を無視します。The default value is StrongWildcard, which ignores the hostname in the match.
maxBufferPoolSizemaxBufferPoolSize このバインディングに使用するバッファー プール サイズの上限を指定する整数。An integer that specifies the maximum buffer pool size for this binding. 既定は 524,288 バイト (512 * 1024) です。The default is 524,288 bytes (512 * 1024). Windows Communication Foundation (WCF) では、多くの部分でバッファーを使用します。Many parts of Windows Communication Foundation (WCF) use buffers. 使用するたびに毎回バッファーを作成および破壊すると負荷が高くなります。バッファーのガベージ コレクションも同様です。Creating and destroying buffers each time they are used is expensive, and garbage collection for buffers is also expensive. バッファー プールを使用すると、バッファーをプールから取得して使用し、作業が終わったらプールに戻すことができます。With buffer pools, you can take a buffer from the pool, use it, and return it to the pool once you are done. これで、バッファーの作成と破棄のオーバーヘッドを回避できます。Thus the overhead in creating and destroying buffers is avoided.
maxReceivedMessageSizemaxReceivedMessageSize このバインディングで構成されるチャネルで受信可能な最大メッセージ サイズ (ヘッダーを含む) をバイト単位で指定する正の整数。A positive integer that specifies the maximum message size, in bytes, including headers, that can be received on a channel configured with this binding. この制限を超えるメッセージの送信者が、SOAP エラーを受信します。The sender of a message exceeding this limit will receive a SOAP fault. メッセージは受信者によって破棄され、トレース ログにこのイベントのエントリが作成されます。The receiver drops the message and creates an entry of the event in the trace log. 既定値は 65536 です。The default is 65536.
messageEncodingmessageEncoding メッセージのエンコードに使用されるエンコーダーを定義します。Defines the encoder used to encode the message. 以下の値が有効です。Valid values include the following:

: テキストは、テキスト メッセージ エンコーダーを使用します。- Text: Use a text message encoder.
Mtom: は、メッセージ Transmission Organization Mechanism 1.0 (MTOM) エンコーダーを使用します。- Mtom: Use a Message Transmission Organization Mechanism 1.0 (MTOM) encoder.
-既定値はテキストです。- The default is Text.

この属性は WSMessageEncoding 型です。This attribute is of type WSMessageEncoding.
namename バインディングの構成名を格納する文字列です。A string that contains the configuration name of the binding. この値は、バインディングの ID として使用されるため、一意にする必要があります。This value should be unique because it is used as an identification for the binding. .NET Framework 4.NET Framework 4 以降では、バインディングおよび動作に名前を付ける必要はありません。Starting with .NET Framework 4.NET Framework 4, bindings and behaviors are not required to have a name. 既定の構成と無名のバインディングおよび動作の詳細については、次を参照してください。簡略化された構成WCF サービスの構成を簡略化です。For more information about default configuration and nameless bindings and behaviors, see Simplified Configuration and Simplified Configuration for WCF Services.
openTimeoutopenTimeout 実行中の操作が完了するまでの時間間隔を指定する TimeSpan 値です。A TimeSpan value that specifies the interval of time provided for an open operation to complete. この値は必ず Zero 以上である必要があります。This value should be greater than or equal to Zero. 既定値は 00:01:00 です。The default is 00:01:00.
proxyAddressproxyAddress HTTP プロキシのアドレスを指定する URI。A URI that specifies the address of the HTTP proxy. useDefaultWebProxytrue の場合、この設定を null にする必要があります。If useDefaultWebProxy is true, this setting must be null. 既定値は、null です。The default is null.
receiveTimeoutreceiveTimeout 受信操作が完了するまでの時間間隔を指定する TimeSpan 値です。A TimeSpan value that specifies the interval of time provided for a receive operation to complete. この値は必ず Zero 以上である必要があります。This value should be greater than or equal to Zero. 既定値は 00:01:00 です。The default is 00:01:00.
sendTimeoutsendTimeout 送信操作が完了するまでの時間間隔を指定する TimeSpan 値です。A TimeSpan value that specifies the interval of time provided for a send operation to complete. この値は必ず Zero 以上である必要があります。This value should be greater than or equal to Zero. 既定値は 00:01:00 です。The default is 00:01:00.
textEncodingtextEncoding バインディングでメッセージの発行に使用される文字セット エンコーディングを設定します。Sets the character set encoding to be used for emitting messages on the binding. 以下の値が有効です。Valid values include the following:

-BigEndianUnicode: Unicode BigEndian エンコーディングします。- BigEndianUnicode: Unicode BigEndian encoding.
Unicode: 16 ビット エンコーディング。- Unicode: 16-bit encoding.
UTF8: 8 ビットのエンコーディング- UTF8: 8-bit encoding

既定値は UTF8 です。The default is UTF8. この属性は Encoding 型です。This attribute is of type Encoding.
transactionFlowtransactionFlow バインディングが WS-Transactions のフローをサポートするかどうかを指定するブール値です。A Boolean value that specifies whether the binding supports flowing WS-Transactions. 既定値は、false です。The default is false.
useDefaultWebProxyuseDefaultWebProxy システムの自動設定 HTTP プロキシを使用するかどうかを示すブール値。A Boolean value that indicates whether the system’s auto-configured HTTP proxy is used. この属性が null の場合、プロキシ アドレスを true (つまり、設定しない) にする必要があります。The proxy address must be null (that is, not set) if this attribute is true. 既定値は、true です。The default is true.

子要素Child Elements

要素Element 説明Description
<security><security> バインディングのセキュリティ設定を定義します。Defines the security settings for the binding. この要素は WSDualHttpSecurityElement 型です。This element is of type WSDualHttpSecurityElement.
<readerQuotas><readerQuotas> このバインドを使用して設定されるエンドポイントにより処理可能な、SOAP メッセージの複雑さに対する制約を定義します。Defines the constraints on the complexity of SOAP messages that can be processed by endpoints configured with this binding. この要素は XmlDictionaryReaderQuotasElement 型です。This element is of type XmlDictionaryReaderQuotasElement.
reliableSessionreliableSession チャネルのエンドポイント間に信頼できるセッションを確立するかどうかを指定します。Specifies if reliable sessions are established between channel endpoints.

親要素Parent Elements

要素Element 説明Description
<bindings><bindings> この要素には、標準バインディングおよびカスタム バインドのコレクションが保持されます。This element holds a collection of standard and custom 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 attribute. 二重バインディングでは、クライアントの 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.

このバインディングは、1 つ以上の SOAP 中継局を通じて信頼できる方法で通信するために使用できます。This binding can be used to communicate reliably through one or more SOAP intermediaries.

既定では、このバインディングは、信頼のための WS-ReliableMessaging、メッセージ セキュリティと認証用 WS-Security、メッセージ配信用 HTTP、および Text/XML メッセージ エンコーディングを持つランタイム スタックを生成します。By default, this binding generates a runtime stack with WS-ReliableMessaging for reliability, WS-Security for message security and authentication, HTTP for message delivery, and a Text/XML message encoding.


        <reliableSession ordered="false"  
            inactivityTimeout="00:02:00" />  
        <security mode="None">  
            <message clientCredentialType="None"  
                algorithmSuite="Aes128" />  

参照See Also

システムが提供するバインディングの構成Configuring System-Provided Bindings
バインディングを使用して、Windows Communication Foundation サービスとクライアントを構成するにはUsing Bindings to Configure Windows Communication Foundation Services and Clients