<defaultProxy > 元素 （網路設定）

  • 發行項

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

<configuration >< system.net <> defaultProxy>

注意

如果您要移轉至 .NET 6+，請使用 HttpClient.DefaultProxy 屬性設定 Proxy 伺服器。

語法

<defaultProxy
  enabled="True|False"
  useDefaultCredentials="True|False">
    <bypasslist>...</bypasslist>
    <proxy>...</proxy>
    <module>...</module>
</defaultProxy>

屬性和元素

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

屬性

Element 說明
enabled 指定是否使用 Web Proxy。 預設值是 True。
useDefaultCredentials 指定此主機的預設認證是否用來存取 Web Proxy。 預設值是 False。

子元素

Element 說明
bypasslist 提供一組位址的規則運算式，說明不使用 Proxy。
module 將新的 Proxy 模組加入至應用程式。
代理 定義 Proxy 伺服器。

父元素

Element 說明
system.net 包含指定 .NET Framework 如何連線到網路的設定。

備註

如果元素是空的 defaultProxy ，則會使用系統 Proxy 設定。

如果 模組 專案指定非公用類型、類型不是衍生自 IWebProxy 類別、發生這個物件的無參數建構函式的例外狀況，或擷取系統指定的預設 Proxy 時發生例外狀況，則會擲回例外狀況。 例外狀況的 InnerException 屬性應該會有此錯誤的根本原因之詳細資訊。

組態檔

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

範例

下列範例會使用系統 Proxy 中的預設值、指定 Proxy 位址，並略過 Proxy 進行本機存取和 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>

另請參閱