共用方式為

<webHttpBinding>

定義一種綁定元素，用於配置 Windows 通訊基礎（WCF）網路服務的端點，這些端點回應 HTTP 請求而非 SOAP 訊息。

<組態>
   <system.service模型>
     <裝訂>
       <webHttpBinding>

語法

<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

Attribute Description
allowCookies 一個布林值，表示客戶端是否接受 Cookie，並在未來請求中傳播。 默認值為 false。

你可以在與使用 cookie 的 ASMX 網路服務互動時使用此特性。 如此一來，你可以確保從伺服器回傳的 Cookie 會自動複製到未來所有客戶端的請求中。
繞過代理本地 一個布林值，指示是否要繞過代理伺服器取得本地位址。 預設值為 false。
結束 時間 一個 TimeSpan 指定緊密操作完成所需時間間隔的值。 此值應大於或等 Zero於 。 預設值是 00：01：00。
hostnameComparisonMode 指定用於解析 URI 的 HTTP 主機名稱比較模式。 此屬性的型別 HostNameComparisonMode為 ，表示在 URI 匹配時是否使用主機名稱來存取服務。 預設值為 StrongWildcard，忽略了配對中的主機名稱。
maxBufferPoolSize 一個整數，指定此綁定的最大緩衝池大小。 預設為 524,288 位元組（512 × 1024）。 Windows 通訊基礎（WCF）的許多部分都使用緩衝區。 每次使用緩衝區都建立與銷毀成本高昂，緩衝區的垃圾回收也同樣昂貴。 使用緩衝池時，你可以從緩衝池中取一個緩衝區，使用完畢後再歸還給池。 因此避免了建立與銷毀緩衝區的開銷。
最大緩衝區大小 一個整數，指定接收通道訊息緩衝區管理者所分配的最大記憶體容量。 預設值為 524,288（0x80000）位元組。
最大接收訊息大小 一個正整數，指定在設定此綁定的通道上可接收的最大訊息大小（以位元組計，包括標頭）。 超過此限制的訊息發送者將收到錯誤。 接收端會丟棄訊息，並在追蹤日誌中建立事件的條目。 預設是 65536。 註： 僅在相容模式下增加此值 ASP.NET 不足以達成。 你也應該提高 的 httpRuntime 值（參見 httpRuntime Element（ASP.NET 設定結構））。
名稱 一個包含綁定設定名稱的字串。 這個值應該是唯一的，因為它是用來識別裝訂的。 從 .NET Framework 4 開始，綁定和行為不再需要名稱。 欲了解更多關於預設設定及無名綁定與行為的資訊，請參閱簡化設定與簡化配置（Simplified Configuration for WCF Services）。
openTimeout 一個 TimeSpan 指定開啟操作完成所需時間區間的值。 此值應大於或等 Zero於 。 預設值是 00：01：00。
proxyAddress 一個指定 HTTP 代理位址的 URI。 若 useSystemWebProxy ， true則此設定必須為 null。 預設值為 null。
收到Timeout 一個 TimeSpan 指定接收操作完成所需時間區間的值。 此值應大於或等 Zero於 。 預設值是 00：01：00。
sendTimeout 一個 TimeSpan 指定傳送操作完成所需時間間隔的值。 此值應大於或等 Zero於 。 預設值是 00：01：00。
transferMode。 一個 TransferMode 表示以綁定配置服務是否使用串流、緩衝（或兩者兼有）訊息傳輸模式的值。 預設值為 Buffered。
useDefaultWebProxy 一個布林值，指定系統自動設定的 HTTP 代理是否被使用。 預設值為 true。
write編碼 指定用於訊息文字的字元編碼。 有效的數值包括以下幾項：

UnicodeFffeTextEncoding：Unicode BigEndian 編碼。

Utf16TextEncoding：16位元編碼。

Utf8TextEncoding：8位元編碼。

預設是 Utf8TextEncoding。

子專案

元素 Description
<讀者配額> 定義了對端點可處理POX訊息複雜度的限制，這些訊息可由配置為此綁定的端點所能處理。 此元素的類型 XmlDictionaryReaderQuotasElement為 。
<安全> 定義綁定的安全設定。 此元素的類型 WebHttpSecurityElement為 。

父項目

元素 Description
<裝訂> 此元素包含標準與自訂裝訂的集合。

備註

WCF 網頁程式設計模型允許開發者透過使用 「普通 XML」（POX）式訊息而非基於 SOAP 的 HTTP 請求來暴露 WCF Web 服務。 用戶端若要使用 HTTP 請求與服務通訊，服務端點必須設定為<附加 WebHttpBehavior 的 webHttpBinding>。<>

在 WCF 中支援聯播與 ASP。AJAX 整合皆建立在網頁程式設計模型之上。 欲了解更多模型資訊，請參閱 WCF Web HTTP 程式設計模型。

另請參閱

  • Last updated on