<webHttpBinding>

發行項
05/22/2023

定義用來設定 Windows Communication Foundation (WCF) Web 服務端點的繫結元素，而這些 Web 服務會回應 HTTP 要求，而非 SOAP 訊息。

<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>

屬性和項目

下列各節說明屬性、子元素和父元素

屬性

屬性	描述
allowCookies	布林值，表示用戶端是否接受 Cookie 並在未來要求時傳播 Cookie。預設值為 false。當您與使用 Cookie 的 ASMX Web 服務互動時，可以使用這個屬性。如此一來，從伺服器傳回的 Cookie 就一定會自動複製到該服務未來所有的用戶端要求。
bypassProxyOnLocal	布林值，指出本機位址是否略過 Proxy 伺服器。預設值為 `false`。
closeTimeout	TimeSpan 值，指定提供用來讓關閉作業完成的時間間隔。這個值應該大於或等於 Zero。預設為 00:01:00。
hostnameComparisonMode	指定用於剖析 URI 的 HTTP 主機名稱比較模式。這個屬性的型別為 HostNameComparisonMode，表示比對 URI 時此主機名稱是否會用來取用服務。預設值為 StrongWildcard，表示比對時忽略主機名稱。
maxBufferPoolSize	指定此繫結之緩衝區集區大小上限的整數。預設為 524,288 個位元組 (512 * 1024)。 Windows Communication Foundation (WCF) 的許多部分會使用緩衝區。每次使用這些組件時建立並終結緩衝區是高度耗費資源的作業，回收緩衝區的記憶體也是如此。有了緩衝集區，您就可以從集區取出緩衝區來使用，用完後再還給集區，因此可以避免建立及終結緩衝區的負荷。
maxBufferSize	整數，指定配置供從通道接收訊息之訊息緩衝區管理員使用的最大記憶體量。預設值為 524,288 (0x80000) 位元組。
maxReceivedMessageSize	正整數，指定在使用此繫結設定之通道上可以接收的訊息大小上限 (以位元組為單位，包括標頭)。超出此限制之訊息的寄件者將會收到錯誤。收件者會捨棄訊息，然後在追蹤記錄檔中建立此事件的項目。預設值為 65536。注意：單獨增加此值並不足以 ASP.NET 相容模式。您也應該增加 (的值 `httpRuntime` ，請參閱 HTTPRuntime 元素 (ASP.NET 設定架構) ) 。
NAME	包含繫結之組態名稱的字串。這個值應該是唯一的，因為它會當做繫結的識別使用。從 .NET Framework 4 開始，不需要有名稱的系結和行為。如需預設設定、無名稱繫結與行為的詳細資訊，請參閱簡化的組態 (部分機器翻譯) 與WCF 服務的簡化組態 (部分機器翻譯)。
openTimeout	TimeSpan 值，指定提供用來讓開啟作業完成的時間間隔。這個值應該大於或等於 Zero。預設為 00:01:00。
proxyAddress	指定 HTTP Proxy 位址的 URI。如果 `useSystemWebProxy` 為 `true`，則這項設定必須為 `null`。預設值為 `null`。
receiveTimeout	TimeSpan 值，指定接收作業完成其作業之時間間隔。這個值應該大於或等於 Zero。預設為 00:01:00。
sendTimeout	TimeSpan 值，指定提供用來讓傳送作業完成的時間間隔。這個值應該大於或等於 Zero。預設為 00:01:00。
transferMode.	TransferMode 值，指出以繫結設定的服務使用訊息傳輸的資料流處理模式或緩衝處理模式 (或兩者)。預設值為 `Buffered`。
useDefaultWebProxy	布林值，指定是否使用系統自動設定的 HTTP Proxy。預設值為 `true`。
writeEncoding	指定用於訊息文字的字元編碼。有效值如下： UnicodeFffeTextEncoding：Unicode BigEndian 編碼方式。 Utf16TextEncoding：16 位元編碼方式。 Utf8TextEncoding：8 位元編碼方式。預設為 Utf8TextEncoding。

子元素

元素	描述
<readerQuotas>	定義 POX 訊息複雜度的條件約束，而這些條件約束可由以此繫結所設定的端點處理。此項目的型別為 XmlDictionaryReaderQuotasElement。
<security>	定義繫結的安全性設定。此項目的型別為 WebHttpSecurityElement。

父項目

元素	描述
<bindings>	這個項目會保存標準和自訂繫結的集合。

備註

WCF Web 程式設計模型可讓開發人員透過使用 "plain old XML" (POX) 樣式傳訊 (而非 SOAP 傳訊) 的 HTTP 要求公開 WCF Web 服務。針對使用 HTTP 要求與服務進行通訊的用戶端，必須使用本身已附加 <WebHttpBehavior> 的 <webHttpBinding> 來設定服務的端點。

WCF 中針對摘要整合和 ASP.AJAX 整合的支援都是根據 Web 程式設計模型所建置。如需模型的詳細資訊，請參閱 WCF Web HTTP 程式設計模型。

共用方式為

<webHttpBinding>

Syntax

屬性和項目

屬性

子元素

父項目

備註

另請參閱

其他資源