共用方式為

<httpTransport>

  • 發行項

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

結構描述階層

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

語法

<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"
IntegratedWindowsAuthentication: Specifies Windows authentication"
    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 或內部網路上的位址。

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

如果您希望用戶端在與相同電腦上的服務進行交談時通過 Proxy，應使用主機名稱而非 localhost。

hostnameComparisonMode

指定用於剖析 URI 的 HTTP 主機名稱比較模式。有效值為：

  • StrongWildcard：(“+”) 比對指定之配置、連接埠和相對 URI 的內容中所有可能的主機名稱。

  • Exact：無萬用字元。

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

預設為 StrongWildcard。此屬性的型別為 HostnameComparisonMode。

keepAliveEnabled

布林值，指定是否要與網際網路資源建立持續連線。

maxBufferSize

正整數，指定緩衝區的大小上限。預設為 524288。

proxyAddress

指定 HTTP Proxy 位址的 URI。如果 useSystemWebProxy 為 true，則這項設定必須為 null。預設為 null。

proxyAuthenticationScheme

指定通訊協定，用於驗證由 HTTP Proxy 處理的用戶端要求。有效值包括以下的值：

  • None：未執行驗證。

  • Digest：指定摘要式驗證。

  • Negotiate：與用戶端交涉，以決定驗證配置。如果用戶端和伺服器都支援 Kerberos，就使用它，否則使用 NTLM。

  • Ntlm：指定 NTLM 驗證。

  • Basic：指定基本驗證。

  • Anonymous：指定匿名驗證。

  • IntegratedWindowsAuthentication：指定 Windows 驗證。

預設值為 Anonymous。此屬性的型別為 AuthenticationSchemes。

realm

字串，指定在 Proxy/伺服器上使用的領域。預設為空字串。

伺服器使用領域來分割受保護的資源。每個分割都可以有自己的驗證配置和 (或) 授權資料庫。領域只限於基本和摘要式驗證使用。當用戶端成功驗證之後，驗證對指定領域中的所有資源都有效。如需領域的詳細說明，請參閱 RFC 2617，網址為 http://www.ietf.org。

transferMode

指定訊息是否要經過緩衝處理或資料流處理，或為要求或回應。有效值包括以下的值：

  • Buffered：緩衝處理要求訊息和回應訊息。

  • Streamed：資料流處理要求訊息和回應訊息。

  • StreamedRequest：資料流處理要求訊息，緩衝處理回應訊息。

  • StreamedResponse：緩衝處理要求訊息，資料流處理回應訊息。

預設為 Buffered。此屬性的型別為 TransferMode。

unsafeConnectionNtlmAuthentication

布林值，指定是否已在伺服器啟用「不安全的連線共用」。預設為 false。如果已啟用，NTLM 驗證會在各 TCP 連線上執行一次。

useDefaultWebProxy

布林值，指定是否使用整部機器 Proxy 設定而非使用者特定設定。預設為 true。

項目子系

無

父項目

項目 描述

<binding>

定義自訂繫結的所有繫結功能。

備註

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

另請參閱

參考

<customBinding>
HttpTransportElement
HttpTransportBindingElement
TransportBindingElement
CustomBinding

其他資源

Transports in Windows Communication Foundation
Choosing a Transport
Windows Communication Foundation Bindings
Extending Bindings
Custom Bindings