<proxy> 元素（網路設定）

定義了代理伺服器。

<configuration>
  <system.net>
    <defaultProxy>
      <proxy>

語法

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

屬性和項目

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

Attributes

Attribute 說明
autoDetect 指定代理是否會自動被偵測。 預設值是 Unspecified。
bypassonlocal 指定代理是否被繞過以取得本地資源。 本地資源包括本地伺服器（http://localhost、 http://loopback或 http://127.0.0.1）以及一個無句點（）http://webserver的 URI。 預設值是 Unspecified。
proxyaddress 指定要使用的代理 URI。
scriptLocation 指定設定腳本的位置。 不要使用 bypassonlocal 帶有此屬性的屬性。
usesystemdefault 指定是否使用系統代理設定。 若設為 True，後續屬性將覆寫系統代理設定。 預設值是 Unspecified。

子元素

沒有。

父項目

元素 說明
defaultProxy 配置超文本傳輸協定（HTTP）代理伺服器。

文字值

備註

該 proxy 元素定義了一個應用程式的代理伺服器。 如果設定檔中缺少此元素，.NET Framework 將使用系統代理設定。

屬性的值 proxyaddress 應該是一個良好形式的統一資源指示符（URI）。

該 scriptLocation 屬性指的是自動偵測代理設定腳本的功能。 WebProxy當在網際網路屬性中選擇使用自動設定腳本選項時，類別會嘗試尋找一個設定腳本（通常稱為 Wpad.dat）。 若 bypassonlocal 設為任意值， scriptLocation 則忽略。

若屬性 proxyaddress 指定無效的預設代理，則會拋出例外。 InnerException例外上的屬性應該包含更多關於錯誤根本原因的資訊。

組態檔

此元素可用於應用程式設定檔或機器設定檔（Machine.config）。

Example

以下範例使用系統代理的預設值，指定代理位址，並繞過代理伺服器進行本地存取。

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

另請參閱

  • Last updated on