HttpClientHandler.Proxy Propriété

Définition

Espace de noms:

System.Net.Http

Assembly:

System.Net.Http.dll

Source:

HttpClientHandler.cs

Obtient ou définit les informations du proxy utilisées par le gestionnaire.

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

Valeur de propriété

IWebProxy

Informations du proxy utilisées par le gestionnaire. La valeur par défaut est null.

Attributs

UnsupportedOSPlatformAttribute

Remarques

La propriété Proxy identifie l’objet WebProxy à utiliser pour traiter les demandes adressées aux ressources Internet. Pour spécifier qu’aucun proxy ne doit être utilisé, définissez la propriété Proxy sur l’instance de proxy retournée par la méthode GetEmptyWebProxy.

L’ordinateur local ou le fichier de configuration de l’application peut spécifier qu’un proxy par défaut doit être utilisé. Si la Proxy propriété est spécifiée, les paramètres de proxy de la Proxy propriété remplacent le fichier de configuration de l’application ou de l’ordinateur local et le gestionnaire utilise les paramètres de proxy spécifiés. Si aucun proxy n’est spécifié dans un fichier de configuration et que la Proxy propriété n’est pas spécifiée, le gestionnaire utilise les paramètres de proxy hérités d’Internet Explorer sur l’ordinateur local. S’il n’existe aucun paramètre proxy dans Internet Explorer, la demande est envoyée directement au serveur.

La HttpClientHandler classe analyse une liste de contournement de proxy avec des caractères génériques hérités d’Internet Explorer la même que la liste de contournement est analysée directement par Internet Explorer. Par exemple, la HttpClientHandler classe analyse une liste de contournement de « nt* » à partir d’Internet Explorer en tant qu’expression régulière de « nt.* ». Ainsi, une URL de http://nt.com contourne le proxy à l’aide de la HttpClientHandler classe et de l’Explorer Internet.

La classe HttpClientHandler prend en charge la déviation du proxy local. La classe considère qu’une destination est locale si l’une des conditions suivantes est remplie :

1. La destination contient un nom plat (aucun point dans l’URL).

2. La destination contient une adresse de bouclage (Loopback ou IPv6Loopback) ou la destination contient un IPAddress affecté à l’ordinateur local.

3. Le suffixe de domaine de la destination correspond au suffixe de domaine de l’ordinateur local (DomainName).