共用方式為

<proxy> 項目 (網路設定)

  • 發行項

更新：2007 年 11 月

定義 Proxy 伺服器。

<configuration> 項目
  <system.Net> 項目 (網路設定)
    <defaultProxy> 項目 (網路設定)
      <proxy> 項目 (網路設定)

<proxy 
  autoDetect="true|false|unspecified"  
  bypassonlocal="true|false|unspecified" 
  proxyaddress="uriString"
  scriptLocation="uriString" 
  usesystemdefault="true|false|unspecified " 
/>

屬性和項目

下列小節將說明屬性、子項目和父項目。

屬性

屬性

描述

autoDetect

指定是否會自動偵測 Proxy。預設值為 unspecified。

bypassonlocal

指定針對本機資源是否略過 Proxy。本機資源包括本機伺服器 (https://localhost、https://loopback 或 http://127.0.0.1) 和沒有句號的 URI (http://webserver)。預設值為 unspecified。

proxyaddress

指定要使用的 Proxy URI。

scriptLocation

指定組態指令碼的位置。

usesystemdefault

指定是否要使用 Internet Explorer Proxy 設定值。如果設定為 true，後續的屬性就會覆寫 Internet Explorer Proxy 設定值。預設值為 unspecified。

子項目

無

父項目

項目

描述

defaultProxy

設定超文字傳輸協定 (HTTP) Proxy 伺服器。

備註

proxy 項目會定義應用程式的 Proxy 伺服器。如果組態檔中遺失此項目，.NET Framework 就會使用 Internet Explorer 中的 Proxy 設定值。

proxyaddress 屬性的值必須是語式正確 (Well-Formed) 的 Uniform Resource Indicator (URI)。

scriptLocation 屬性是指自動偵測 Proxy 組態指令碼。如果已在 Internet Explorer 中選取 [使用自動組態指令碼] 選項，WebProxy 類別將會嘗試尋找組態指令碼 (通常叫做 Wpad.dat)。

針對要由 .NET Framework 1.1 版移轉至 2.0 版的應用程式使用 usesystemdefault 屬性。

組態檔

這個項目可以用於應用程式組態檔或電腦組態檔 (Machine.config)。

範例

下列程式碼範例會使用 Internet Explorer Proxy 的預設值，指定 Proxy 位址，並且略過本機存取的 Proxy。

<configuration>
  <system.net>
    <defaultProxy>
      <proxy
        usesystemdefault="true"
        proxyaddress="http://192.168.1.10:3128"
        bypassonlocal="true"
      />
    </defaultProxy>
  </system.net>
</configuration>

請參閱

參考

網路設定結構描述

System.Net.WebProxy