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

Article
04/03/2023

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>