HttpClientHandler.Proxy 屬性

定義

命名空間:

System.Net.Http

組件:

System.Net.Http.dll

來源:

HttpClientHandler.cs

取得或設定處理常式所使用的 Proxy 資訊。

public:
 property System::Net::IWebProxy ^ Proxy { System::Net::IWebProxy ^ get(); void set(System::Net::IWebProxy ^ value); };

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Runtime.Versioning.UnsupportedOSPlatform("ios")]
[System.Runtime.Versioning.UnsupportedOSPlatform("tvos")]
public System.Net.IWebProxy? Proxy { get; set; }

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("ios")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("tvos")>]
member this.Proxy : System.Net.IWebProxy with get, set

Public Property Proxy As IWebProxy

屬性值

IWebProxy

處理常式所使用的 Proxy 資訊。 預設值是 null。

屬性

UnsupportedOSPlatformAttribute

備註

Proxy 屬性會識別 WebProxy 物件，以用來處理向網際網路資源發出的要求。 若要指定不應使用 Proxy，請將 Proxy 屬性設定為 GetEmptyWebProxy 方法所傳回的 Proxy 執行個體。

本機電腦或應用程式組態檔可能會指定要使用的預設 Proxy。 Proxy如果指定了 屬性，則來自 屬性的 Proxy Proxy 設定會覆寫本機電腦或應用程式組態檔，而處理常式將會使用指定的 Proxy 設定。 如果未在組態檔中指定任何 Proxy，而且 Proxy 未指定 屬性，則處理常式會使用繼承自本機電腦上的 Internet Explorer 的 Proxy 設定。 如果 Internet Explorer 中沒有 Proxy 設定，要求會直接傳送至伺服器。

類別會 HttpClientHandler 剖析具有繼承自 Internet Explorer 之萬用字元的 Proxy 略過清單，就像 Internet Explorer 直接剖析略過清單一樣。 例如，類別 HttpClientHandler 會從 Internet Explorer 剖析 「nt*」 的略過清單，作為 「nt.*」 的正則運算式。 因此，的 http://nt.com URL 會略過 使用 類別和 Internet Explorer 的 HttpClientHandler Proxy。

HttpClientHandler 類別支援本機 Proxy 略過。 如果符合下列任何條件，該類別會將目的地視為本機：

1. 目的地包含一般名稱 (URL 中沒有點)。

2. 目的地包含回送位址 (Loopback 或 IPv6Loopback)，或目的地包含指派給本機電腦的 IPAddress。

3. 目的地的網域尾碼符合本機電腦的網域尾碼 (DomainName)。