用戶端通道屬性

發行項
02/15/2011

本主題專門說明一項為了在現有應用程式中提供回溯相容性而保留的舊有技術，不建議用於新的開發工作。分散式應用程式應使用 Windows Communication Foundation (WCF) 進行開發。

下表顯示可指定的用戶端通道屬性。

屬性	說明	支援這個屬性的型別
allowAutoRedirect	布林 (Boolean) 值，指出是否啟用伺服器重新導向的自動處理。	HttpChannel HttpClientChannel
clientConnectionLimit	整數，指出特定伺服器可同時開啟多少連線。預設為 2。	HttpChannel HttpClientChannel
connectionGroupName	字串，指定如果 unsafeAuthenticatedConnectionSharing 值設為 true 時，要當成伺服器之連線群組名稱來使用的名稱。如果 unsafeAuthenticatedConnectionSharing 未設為 true，則會忽略此屬性。如果已指定，請確定此名稱只對應到一個驗證的使用者。在下列平台上，只有 .NET Framework 1.1 版或更新版本支援這個屬性：Windows 98、Windows NT 4.0、Windows Me、Windows 2000、Windows XP Home Edition、Windows XP Professional 和 Windows Server 2003 系列產品。	HttpChannel HttpClientChannel
connectionTimeout	整數，指定成功連線之前所需等候的毫秒數。0 或 -1 代表無限逾時期間。預設為 Infinite。	IpcChannel IpcClientChannel
credentials	實作代表用戶端識別之 ICredentials 介面的物件。	HttpChannel HttpClientChannel
domain	字串，當針對伺服器通道進行驗證時，指定要與 username 所指定的使用者名稱以及 password 所指定的密碼一起使用的網域名稱。	HttpClientChannel TcpClientChannel
password	字串，當針對伺服器通道進行驗證時，指定要與 username 所指定的使用者名稱以及 domain 所指定的網域一起使用的密碼。	HttpClientChannel TcpClientChannel
proxyName	字串，指定在對遠端伺服器進行呼叫時，Proxy 所使用的名稱。根據預設，會使用用戶端電腦的主機名稱。	HttpChannel HttpClientChannel
proxyPort	整數，指定 Proxy 對遠端伺服器進行呼叫時使用的埠號。根據預設，執行階段會選擇可用但未授權的連接埠。	HttpChannel HttpClientChannel
retryCount	整數，指定用戶端重複一開始就失敗的遠端呼叫次數。預設為 1。	TcpClientChannel
servicePrincipleName	字串，指定 Kerberos 驗證的 servicePrincipalName。預設值為 null。	HttpChannel HttpClientChannel TcpChannel TcpClientChannel
socketCachePolicy	SocketCachePolicy 列舉型別的成員，指定由 socketCacheTimeout 屬性所指定的時間是從上次使用通訊端 (Socket) 時開始計算，還是從建立通訊端時起算。預設為 Default。	TcpClientChannel
socketCacheTimeout	以秒為時間指定單位的整數，在此時間之後會從 TcpClientChannel 物件所維護的快取中移除通訊端。預設為五秒鐘。	TcpClientChannel
timeout	整數，指定要求逾時之前的毫秒數。0 或 -1 代表無限逾時期間。預設為 Infinite。	HttpChannel HttpClientChannel TcpChannel TcpClientChannel
tokenImpersonationLevel	型別 TokenImpersonationLevel 的值。此屬性指定伺服器如何驗證用戶端。預設為 None，除非 secure 屬性設為 true，在此情況下預設為 Identification。	TcpChannel TcpClientChannel
unsafeAuthenticatedConnectionSharing	布林值，指出是否允許共用高速 NTLM 驗證連線。如果此值設為 true，則 connectionGroupName 值只能對應至一個驗證的使用者。如果 useAuthenticatedConnectionSharing 值設定為 true，則會忽略這個屬性。在下列平台上，只有 .NET Framework 1.1 版或更新版本支援這個屬性：Windows 98、Windows NT 4.0、Windows Me、Windows 2000、Windows XP Home Edition、Windows XP Professional，和 Windows Server 2003。	HttpChannel HttpClientChannel
useAuthenticatedConnectionSharing	布林值，指出伺服器通道是否要重複使用驗證的連線，而不是驗證每個傳入的呼叫。根據預設，此值將設為 true (如果 useDefaultCredentials 值亦同時設為 true 的話)；否則，此值將設為 false，代表會在伺服器要求驗證時，驗證每個呼叫。您也可以程式設計方式來達到此目的，方法是建立實作 IDictionary 的物件、將 credentials 屬性設為 CredentialCache.DefaultCredentials，並將該值傳遞給通道接收，或是使用由 ChannelServices.GetChannelSinkProperties 方法傳回的 IDictionary。在下列平台上，只有 .NET Framework 1.1 版或更新版本支援這個名稱/值對：Microsoft Windows 98、Windows NT 4.0、Windows Millennium Edition (Windows Me)、Windows 2000、Windows XP Home Edition、Windows XP Professional，和 Windows Server 2003。	HttpChannel HttpClientChannel
useDefaultCredentials	布林值，指定是否要在對伺服器通道進行驗證時，提供與目前執行緒相關聯的識別認證。	HttpChannel HttpClientChannel
username	字串，當針對伺服器通道進行驗證時，指定要與 password 所指定的密碼以及 domain 所指定的網域一起使用的使用者名稱。	HttpClientChannel TcpClientChannel

注意：
在 Windows 98 與 Windows Me 上，未提供任何安全性識別碼供您識別驗證連線群組名稱。因此，在這些平台上只有一個連線群組名稱。

注意：
如果您希望應用程式傳遞 ICredentials 實作或明確的 username、password 以及 HttpClientChannel 屬性中的 domain 值，您可以同時將 unsafeAuthenticatedConnectionSharing 屬性設為 true 並設定 connectionGroupName 屬性來啟用驗證連線共用，以確定 connectionGroupName 值只對應至一個驗證的使用者。

另請參閱

工作

HOW TO：在組態檔中設定通道
 HOW TO：以程式設計方式設定通道

參考

遠端設定結構描述

概念

遠端應用程式的組態
 遠端物件組態
 遠端物件組態