共用方式為

<httpTransport>

  • 發行項

指定 HTTP 傳輸，以傳輸自訂繫結的 SOAP 訊息。

<configuration>
  <system.serviceModel>
    <bindings>
      <customBinding>
        <binding>
          <httpTransport>

Syntax

<httpTransport allowCookies="Boolean"
               authenticationScheme="Digest/Negotiate/Ntlm/Basic/Anonymous"
               bypassProxyOnLocal="Boolean"
               hostnameComparisonMode="StrongWildcard/Exact/WeakWildcard"
               keepAliveEnabled="Boolean"
               maxBufferSize="Integer"
               proxyAddress="Uri"
               proxyAuthenticationScheme="None/Digest/Negotiate/Ntlm/Basic/Anonymous"
               realm="String"
               transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"
               unsafeConnectionNtlmAuthentication="Boolean"
               useDefaultWebProxy="Boolean" />

屬性和項目

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

屬性

屬性 描述
allowCookies 布林值，指定用戶端是否接受 Cookie 並在未來要求時傳播 Cookie。 預設為 false。

當您與使用 Cookie 的 ASMX Web 服務互動時，可以使用這個屬性。 如此一來，從伺服器傳回的 Cookie 就一定會自動複製到該服務未來所有的用戶端要求。
authenticationScheme 指定通訊協定，用於驗證由 HTTP 接聽程式處理的用戶端要求。 有效值如下：

- Digest：指定摘要式驗證。
- Negotiate：與用戶端交涉，以決定驗證配置。 如果用戶端和伺服器都支援 Kerberos，就使用它，否則使用 NTLM。
- Ntlm：指定 NTLM 驗證。
- Basic：指定基本驗證。
- Anonymous：指定匿名驗證。

預設值為 Anonymous。 此屬性的型別為 AuthenticationSchemes。 這個屬性只可以設定一次。
bypassProxyOnLocal 布林值，指出本機位址是否略過 Proxy 伺服器。 預設為 false。

本機位址是位於本機 LAN 或內部網路上的位址。

如果服務位址以 http://localhost 開頭，Windows Communication Foundation (WCF) 一律會忽略 Proxy。

如果您希望用戶端在與相同電腦上的服務進行交談時通過 Proxy，應使用主機名稱而非 localhost。
hostnameComparisonMode 指定用於剖析 URI 的 HTTP 主機名稱比較模式。 有效值為：

- StrongWildcard：("+") 比對指定配置、連接埠和相對 URI 的內容中所有可能的主機名稱。
- Exact：無萬用字元
- WeakWildcard：("*") 比對指定配置、連接埠和相對 UIR 的內容中，所有尚未明確比對或透過強式萬用字元機制比對的可能主機名稱。

此屬性的型別為 HostNameComparisonMode。 預設值為 StrongWildcard。
keepAliveEnabled 布林值，指定是否要與網際網路資源建立持續連線。
maxBufferSize 正整數，指定緩衝區的大小上限。 預設為 524288。
proxyAddress 指定 HTTP Proxy 位址的 URI。 如果 useSystemWebProxy 為 true，則這項設定必須為 null。 預設值為 null。
proxyAuthenticationScheme 指定通訊協定，用於驗證由 HTTP Proxy 處理的用戶端要求。 有效值如下：

- None：未執行驗證。
- Digest：指定摘要式驗證。
- Negotiate：與用戶端交涉，以決定驗證配置。 如果用戶端和伺服器都支援 Kerberos，就使用它，否則使用 NTLM。
- Ntlm：指定 NTLM 驗證。
- Basic：指定基本驗證。
- Anonymous：指定匿名驗證。

預設值為 Anonymous。 此屬性的型別為 AuthenticationSchemes。 請注意，不支援 AuthenticationSchemes.IntegratedWindowsAuthentication。
realm 字串，指定在 Proxy/伺服器上使用的領域。 預設為空字串。

伺服器使用領域來分割受保護的資源。 每個分割都可以有自己的驗證配置和 (或) 授權資料庫。 領域只限於基本和摘要式驗證使用。 當用戶端成功驗證之後，驗證對指定領域中的所有資源都有效。 如需領域的詳細說明，請參閱 IETF 網站上的 RFC 2617。
transferMode 指定訊息是否要經過緩衝處理或資料流處理，或為要求或回應。 有效值如下：

- Buffered：緩衝處理要求訊息和回應訊息。
- Streamed：資料流處理要求訊息和回應訊息。
- StreamedRequest：資料流處理要求訊息，緩衝處理回應訊息。
- StreamedResponse：緩衝處理要求訊息，資料流處理回應訊息。

預設為 Buffered。 此屬性的型別為 TransferMode。
unsafeConnectionNtlmAuthentication 布林值，指定是否已在伺服器啟用「不安全的連線共用」。 預設為 false。 如果已啟用，NTLM 驗證會在各 TCP 連線上執行一次。
useDefaultWebProxy 布林值，指定是否使用整部機器 Proxy 設定而非使用者特定設定。 預設值為 true。

子元素

無

父項目

元素 描述
<binding> 定義自訂繫結的所有繫結功能。

備註

httpTransport 項目是在建立自訂繫結時的起點，該繫結會實作 HTTP 傳輸通訊協定。 HTTP 是用於互通性目的的主要傳輸。 此傳輸是由 Windows Communication Foundation (WCF) 支援，可確保與其他非 WCF Web 服務堆疊之間的互通性。

另請參閱