共用方式為

<httpsTransport>

  • 發行項

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

結構描述階層

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

語法

<httpsTransport
    allowCookies=Boolean"
    authenticationScheme="Digest/Negotiate/Ntlm/Basic/Anonymous"
    bypassProxyOnLocal=Boolean"
    hostnameComparisonMode="StrongWildcard/Exact/WeakWildcard"
    manualAddressing="Boolean"
    maxBufferPoolSize="Integer"
    maxBufferSize="Integer"
    maxReceivedMessageSize="Integer"
    proxyAddress="Uri"
    proxyAuthenticationScheme="None/Digest/Negotiate/Ntlm/Basic/Anonymous"
IntegratedWindowsAuthentication: Specifies Windows authentication"
    realm="String"
    requireClientCertificate=Boolean"
    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。

manualAddressing

布林值，讓使用者能夠控制訊息定址。這個屬性通常用於路由器案例，其中應用程式會決定要將訊息傳送到其中一個目的端。

設定為 true 時，通道會假設訊息已經定址，並且不會加入任何其他的資訊。接著使用者可個別定址每一個訊息。

設定為 false 時，預設的 Windows Communication Foundation (WCF) 定址機制會自動為所有訊息建立位址。

預設為 false。

maxBufferPoolSize

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

WCF 有許多組件會使用緩衝區。每次使用這些組件時建立並終結緩衝區是高度耗費資源的作業，回收緩衝區的記憶體也是如此。有了緩衝集區，您就可以從集區取出緩衝區來使用，用完後再還給集區，因此可以避免建立及終結緩衝區的負荷。

maxBufferSize

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

maxReceivedMessageSize

正整數，指定可接收的可允許訊息大小上限。預設為 65536。

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。

requireClientCertificate

布林值，指定伺服器是否需要用戶端提供用戶端憑證做為 HTTPS 信號交換的一部分。預設為 false。

transferMode

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

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

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

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

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

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

unsafeConnectionNtlmAuthentication

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

useDefaultWebProxy

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

項目子系

無。

父項目

項目 描述

<binding>

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

備註

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

另請參閱

參考

<customBinding>
HttpsTransportElement
HttpsTransportBindingElement
TransportBindingElement
CustomBinding

其他資源

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