<webHttpBinding>

SOAP メッセージではなく HTTP 要求に応答する Windows Communication Foundation (WCF) Web サービスのエンドポイントを構成するために使用されるバインド要素を定義します。Defines a binding element that is used to configure endpoints for Windows Communication Foundation (WCF) Web services that respond to HTTP requests instead of SOAP messages.

<configuration>
  <system.serviceModel>
    <bindings>
      <webHttpBinding>

構文Syntax

<webHttpBinding>
  <binding allowCookies="Boolean"
           bypassProxyOnLocal="Boolean"
           closeTimeout="TimeSpan"
           hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"
           maxBufferPoolSize="integer"
           maxBufferSize="integer"
           maxReceivedMessageSize="Integer"
           name="string"
           openTimeout="TimeSpan"
           proxyAddress="URI"
           receiveTimeout="TimeSpan"
           sendTimeout="TimeSpan"
           transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"
           useDefaultWebProxy="Boolean"
           writeEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding">
    <security mode="None/Transport/TransportCredentialOnly">
      <transport clientCredentialType="Basic/Certificate/Digest/None/Ntlm/Windows"
                 proxyCredentialType="Basic/Digest/None/Ntlm/Windows"
                 realm="string" />
    </security>
    <readerQuotas maxArrayLength="Integer"
                  maxBytesPerRead="Integer"
                  maxDepth="Integer"
                  maxNameTableCharCount="Integer"
                  maxStringContentLength="Integer" />
  </binding>
</webHttpBinding>

属性および要素Attributes and Elements

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

属性Attributes

属性Attribute [説明]Description
allowCookiesallowCookies クライアントがクッキーを受け入れて、それらを今後の要求に反映させるかどうかを指定するブール値です。A Boolean value that indicates whether the client accepts cookies and propagates them on future requests. 既定値は false です。The default is false.

クッキーを使用する ASMX Web サービスと対話する場合にこのプロパティを使用できます。You can use this property when you interact with ASMX Web services that use cookies. この方法で、サーバーから返されるクッキーを、それ以降のサービスに対するすべてのクライアント要求に自動的にコピーできます。In this way, you can be sure that the cookies returned from the server are automatically copied to all future client requests for that service.
bypassProxyOnLocalbypassProxyOnLocal ローカル アドレスでプロキシ サーバーをバイパスするかどうかを示すブール値。A Boolean value that indicates whether to bypass the proxy server for local addresses. 既定では、 falseです。The default is false.
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.
maxBufferSizemaxBufferSize チャネルからメッセージを受け取るメッセージ バッファーのマネージャーが使用するために割り当てられる最大メモリ量を指定する整数。An integer that specifies the maximum amount of memory that is allocated for use by the manager of the message buffers that receive messages from the channel. 既定値は 524,288 (0x80000) バイトです。The default value is 524,288 (0x80000) bytes.
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. この制限を超えるメッセージの送信者はエラーを受信します。The sender of a message exceeding this limit will receive a fault. メッセージは受信者によってドロップされ、トレース ログにこのイベントのエントリが作成されます。The receiver drops the message and creates an entry of the event in the trace log. 既定値は 65536 です。The default is 65536. 注: ASP.NET 互換モードでは、この値だけを大きくするだけでは十分ではありません。Note: Increasing this value alone is not sufficient in ASP.NET compatible mode. また、の値を大きくする必要があり httpRuntime ます (「 httpRuntime 要素 (ASP.NET Settings Schema)」を参照してください)。You should also increase the value of httpRuntime (see httpRuntime Element (ASP.NET Settings Schema)).
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 以降では、バインドと動作に名前を付ける必要はありません。Starting with .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. useSystemWebProxytrue の場合、この設定を null にする必要があります。If useSystemWebProxy 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.
transferModetransferMode. バインディングで構成されたサービスがメッセージ転送のストリーム モードまたはバッファー モード (あるいは両方のモード) を使用するかどうかを示す TransferMode 値。A TransferMode value that indicates whether the service configured with the binding uses streamed or buffered (or both) modes of message transfer. 既定では、 Bufferedです。The default is Buffered.
useDefaultWebProxyuseDefaultWebProxy システムの自動設定 HTTP プロキシを使用するかどうかを指定するブール値。A Boolean value that specifies whether the system’s auto-configured HTTP proxy is used. 既定では、 trueです。The default is true.
writeEncodingwriteEncoding メッセージ テキストに使用される文字エンコーディングを指定します。Specifies the character encoding that is used for the message text. 有効な値は次のとおりです。Valid values include the following:

UnicodeFffeTextEncoding: Unicode BigEndian エンコーディング。UnicodeFffeTextEncoding: Unicode BigEndian encoding.

Utf16TextEncoding: 16 ビットのエンコーディング。Utf16TextEncoding: 16-bit encoding.

Utf8TextEncoding: 8 ビットのエンコーディング。Utf8TextEncoding: 8-bit encoding.

既定値は Utf8TextEncoding です。The default is Utf8TextEncoding.

子要素Child Elements

要素Element 説明Description
<readerQuotas> このバインディングを使用して構成されるエンドポイントにより処理可能な、POX メッセージの複雑さに対する制約を定義します。Defines the constraints on the complexity of POX messages that can be processed by endpoints configured with this binding. この要素は XmlDictionaryReaderQuotasElement 型です。This element is of type XmlDictionaryReaderQuotasElement.
<security> バインディングのセキュリティ設定を定義します。Defines the security settings for the binding. この要素は WebHttpSecurityElement 型です。This element is of type WebHttpSecurityElement.

親要素Parent Elements

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

解説Remarks

WCF Web プログラミングモデルを使用すると、開発者は、SOAP ベースのメッセージングではなく "plain old XML" (POX) スタイルのメッセージングを使用する HTTP 要求を介して WCF Web サービスを公開できます。The WCF Web Programming Model allows developers to expose WCF Web services through HTTP requests that use "plain old XML" (POX) style messaging instead of SOAP-based messaging. クライアントが HTTP 要求を使用してサービスと通信するには、サービスのエンドポイントがに接続されたを使用して構成されている必要があり <webHttpBinding> <WebHttpBehavior> ます。For clients to communicate with a service using HTTP requests, an endpoint of the service must be configured with the <webHttpBinding> that has the <WebHttpBehavior> attached to it.

配信および ASP の WCF でのサポート。AJAX 統合は、どちらも Web プログラミングモデル上に構築されています。Support in WCF for syndication and ASP.AJAX integration are both built on top of the Web Programming Model. モデルの詳細については、「 WCF WEB HTTP プログラミングモデル」を参照してください。For more information on the model, see WCF Web HTTP Programming Model.

関連項目See also