共用方式為


<proxy> 元素(網路設定)

定義了代理伺服器。

<組態>
   <system.net>
     <defaultProxy>
       <代理>

語法

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

屬性和項目

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

Attributes

Attribute 說明
autoDetect 指定代理是否會自動被偵測。 預設值是 Unspecified
bypassonlocal 指定代理是否被繞過以取得本地資源。 本地資源包括本地伺服器(http://localhosthttp://loopbackhttp://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>

另請參閱