Partager via


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

Définit un serveur proxy.

<configuration>
  <system.net>
    <defaultProxy>
      <proxy>

Syntaxe

<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 (http://localhost, http://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 du proxy à utiliser.
scriptLocation Spécifie l’emplacement du script de configuration. N’utilisez pas l’attribut bypassonlocal avec cet attribut.
usesystemdefault Spécifie s’il faut utiliser les paramètres de proxy du système. S’il est défini sur True, les attributs qui suivent remplacent les paramètres de proxy du système. La valeur par défaut est Unspecified.

Éléments enfants

Aucune.

Éléments parents

Element Description
defaultProxy Configure le serveur proxy HTTP (Hypertext Transfer Protocol).

Valeur texte

Notes

L’élément proxy définit un serveur proxy pour une application. Si cet élément est manquant dans le fichier de configuration, le .NET Framework utilisera les paramètres de proxy du système.

La valeur de l’attribut proxyaddress doit être un URI (Uniform Resource Indicator) bien formé.

L’attribut scriptLocation fait référence à la détection automatique des scripts de configuration de proxy. La classe WebProxy va tenter de localiser un script de configuration (généralement nommé Wpad.dat) quand l’option Utiliser le script de configuration automatique est sélectionnée dans les propriétés Internet. Si bypassonlocal est défini sur n’importe quelle valeur, scriptLocation est ignoré.

Une exception est levée si l’attribut proxyaddress spécifie un proxy par défaut non valide. La propriété InnerException de l'exception fournit normalement plus d'informations sur la cause première de l'erreur.

Fichiers de configuration

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

Exemple

L’exemple suivant utilise les valeurs par défaut du proxy du système, spécifie l’adresse du 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