配置超文本傳輸協定(HTTP)代理伺服器。
<defaultProxy system.net configuration><><>
備註
如果你要遷移到 .NET 6+,請用屬性 HttpClient.DefaultProxy 設定代理伺服器。
語法
<defaultProxy
enabled="True|False"
useDefaultCredentials="True|False">
<bypasslist>...</bypasslist>
<proxy>...</proxy>
<module>...</module>
</defaultProxy>
屬性和元素
下列章節說明屬性、子元素和父元素。
Attributes
| 元素 | 說明 |
|---|---|
enabled |
指定是否使用網頁代理。 預設值是 True。 |
useDefaultCredentials |
指定是否使用此主機的預設憑證來存取網頁代理。 預設值是 False。 |
子專案
| 元素 | 說明 |
|---|---|
| 旁路表 | 提供一組正則表達式,描述不使用代理的位址。 |
| module | 為應用程式新增一個代理模組。 |
| 代理 | 定義了代理伺服器。 |
父元素
| 元素 | 說明 |
|---|---|
| system.net | 包含指定 .NET Framework 如何連接網路的設定。 |
備註
若元素 defaultProxy 為空,則使用系統代理設定。
若 模組 元素指定非公開型別、型別未源自 IWebProxy 類別、該物件的無參數建構器出現異常,或在取得系統指定的預設代理時發生異常,則會拋出例外。 InnerException例外上的屬性應該包含更多關於錯誤根本原因的資訊。
組態檔
此元素可用於應用程式設定檔或機器設定檔(Machine.config)。
Example
以下範例使用系統代理的預設值,指定代理地址,並繞過代理伺服器進行本地存取與 contoso.com。
<configuration>
<system.net>
<defaultProxy>
<proxy
usesystemdefault="True"
proxyaddress="http://192.168.1.10:3128"
bypassonlocal="True"
/>
<bypasslist>
<add address="[a-z]+\.contoso\.com$" />
</bypasslist>
</defaultProxy>
</system.net>
</configuration>