<proxy>, élément (paramètres réseau)

Article
08/21/2008

Mise à jour : novembre 2007

Définit un serveur proxy.

<configuration>, élément
  <system.Net>, élément (paramètres réseau)
    <defaultProxy>, élément (paramètres réseau)
      <proxy>, élément (paramètres réseau)

<proxy 
  autoDetect="true|false|unspecified"  
  bypassonlocal="true|false|unspecified" 
  proxyaddress="uriString"
  scriptLocation="uriString" 
  usesystemdefault="true|false|unspecified " 
/>

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut	Description
autoDetect	Spécifie si le proxy est détecté automatiquement. La valeur par défaut est unspecified.
bypassonlocal	Spécifie si le proxy est contourné pour les ressources locales. Les ressources locales incluent le serveur local (https://localhost, https://loopback ou http://127.0.0.1) et un URI sans point (http://webserver). La valeur par défaut est unspecified.
proxyaddress	Spécifie l'URI de proxy à utiliser.
scriptLocation	Spécifie l'emplacement du script de configuration.
usesystemdefault	Spécifie s'il faut utiliser des paramètres de proxy Internet Explorer. Si sa valeur est true, les attributs suivants substitueront les paramètres de proxy Internet Explorer. La valeur par défaut est unspecified.

Éléments enfants

Aucun.

Éléments parents

Élément	Description
defaultProxy	Configure le serveur proxy HTTP (Hypertext Transfer Protocol).

Notes

L'élément proxy définit un serveur proxy pour une application. Si cet élément est absent du fichier de configuration, le .NET Framework utilise les paramètres de proxy dans Internet Explorer.

La valeur de l'attribut proxyaddress doit être un identificateur URI (Uniform Resource Indicator) correct.

L'attribut scriptLocation fait référence à la détection automatique des scripts de configuration du proxy. La classe WebProxy tente de localiser un script de configuration (généralement appelé Wpad.dat) lorsque l'option Utiliser un script de configuration automatique est sélectionnée dans Internet Explorer.

Utilisez l'attribut usesystemdefault pour les applications .NET Framework version 1.1 qui effectuent une migration vers la version 2.0.

Fichiers de configuration

Cet élément peut être utilisé dans le fichier de configuration de l'application ou dans le fichier de configuration machine (Machine.config).

Exemple

L'exemple de code suivant utilise les valeurs par défaut du proxy Internet Explorer, spécifie l'adresse proxy et contourne le proxy pour l'accès local.

<configuration>
  <system.net>
    <defaultProxy>
      <proxy
        usesystemdefault="true"
        proxyaddress="http://192.168.1.10:3128"
        bypassonlocal="true"
      />
    </defaultProxy>
  </system.net>
</configuration>

Voir aussi

Référence

Schéma des paramètres réseau

System.Net.WebProxy

Partager via