定義了代理伺服器。
<組態>
<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://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>