共用方式為

<ipv6> 項目 (網路設定)

  • 發行項

定義 Proxy 伺服器。

<configuration>
  <system.net>
    <defaultProxy>
      <Proxy>

Syntax

<proxy
  autoDetect="True|False|Unspecified"
  bypassonlocal="True|False|Unspecified"
  proxyaddress="uriString"
  scriptLocation="uriString"
  usesystemdefault="True|False|Unspecified"
/>

屬性和項目

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

屬性

Attribute 說明
autoDetect 指定是否自動偵測 Proxy。 預設值是 Unspecified。
bypassonlocal 指定是否略過本機資源的 Proxy。 本機資源包括本機伺服器 (http://localhost、http://loopback 或 http://127.0.0.1)，以及不含句點 (http://webserver) 的 URI。 預設值是 Unspecified。
proxyaddress 指定要使用的 Proxy URI。
scriptLocation 指定組態指令碼的位置。 請勿搭配 bypassonlocal 屬性使用這個屬性。
usesystemdefault 指定是否要使用系統 Proxy 設定。 如果設定為 True，後續屬性將會覆寫系統 Proxy 設定。 預設值是 Unspecified。

子元素

無。

父項目

Element 說明
defaultProxy 設定超文字傳輸協定 (HTTP) 的 Proxy 伺服器。

文字值

備註

proxy 項目會定義應用程式的 Proxy 伺服器。 如果組態檔遺漏此元素，則.NET Framework將會使用系統 Proxy 設定。

proxyaddress 屬性的值應該是格式正確的統一資源識別項 (URI)。

scriptLocation 屬性是指 Proxy 組態指令碼的自動偵測。 當選取 [在網際網路屬性中使用自動設定指令碼] 選項時，WebProxy 類別會嘗試 (尋找通常名為 Wpad.dat) 的組態指令碼。 如果 bypassonlocal 設為任何值，則會忽略 scriptLocation。

如果 proxyaddress 屬性指定不正確的預設 Proxy，則會擲回例外狀況。 例外狀況的 InnerException 屬性應該會有此錯誤的根本原因之詳細資訊。

組態檔

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

範例

下列範例會使用來自系統 Proxy 的預設值，指定 Proxy 位址，並略過本機存取 Proxy。

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

另請參閱