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

Définit un serveur proxy.Defines a proxy server.

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

SyntaxeSyntax

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

Attributs et élémentsAttributes and Elements

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.The following sections describe attributes, child elements, and parent elements.

AttributsAttributes

AttributAttribute DescriptionDescription
autoDetect Spécifie si le proxy est détecté automatiquement.Specifies whether the proxy is automatically detected. La valeur par défaut est unspecified.The default value is unspecified.
bypassonlocal Spécifie si le proxy est contourné pour les ressources locales.Specifies whether the proxy is bypassed for local resources. Les ressources locales incluent le serveur local (http://localhost, http://loopback, ou http://127.0.0.1) et un URI sans point (http://webserver).Local resources include the local server (http://localhost, http://loopback, or http://127.0.0.1) and a URI without a period (http://webserver). La valeur par défaut est unspecified.The default value is unspecified.
proxyaddress Spécifie l’URI de proxy à utiliser.Specifies the proxy URI to use.
scriptLocation Spécifie l’emplacement du script de configuration.Specifies the location of the configuration script. N’utilisez pas le bypassonlocal attribut avec cet attribut.Do not use the bypassonlocal attribute with this attribute.
usesystemdefault Spécifie s’il faut utiliser les paramètres de proxy Internet Explorer.Specifies whether to use Internet Explorer proxy settings. Si la valeur true, les attributs suivants remplacent les paramètres de proxy Internet Explorer.If set to true, subsequent attributes will override Internet Explorer proxy settings. La valeur par défaut est unspecified.The default value is unspecified.

Éléments enfantsChild Elements

Aucun.None.

Éléments parentsParent Elements

ÉlémentElement DescriptionDescription
defaultProxydefaultProxy Configure le serveur proxy HTTP (Hypertext Transfer Protocol).Configures the Hypertext Transfer Protocol (HTTP) proxy server.

Valeur texteText Value

NotesRemarks

Le proxy élément définit un serveur proxy pour une application.The proxy element defines a proxy server for an application. Si cet élément est manquant à partir du fichier de configuration, le .NET Framework utilise les paramètres de proxy dans Internet Explorer.If this element is missing from the configuration file, then the .NET Framework will use the proxy settings in Internet Explorer.

La valeur de la proxyaddress attribut doit être un bien formé indicateur URI (Uniform Resource).The value for the proxyaddress attribute should be a well-formed Uniform Resource Indicator (URI).

Le scriptLocation attribut fait référence à la détection automatique des scripts de configuration de proxy.The scriptLocation attribute refers to the automatic detection of proxy configuration scripts. Le WebProxy classe tente de localiser un script de configuration (généralement nommé Wpad.dat) lorsque le utiliser le script de configuration automatique option est sélectionnée dans Internet Explorer.The WebProxy class will attempt to locate a configuration script (usually named Wpad.dat) when the Use automatic configuration script option is selected in Internet Explorer. Si bypassonlocal est définie sur n’importe quelle valeur, scriptLocation est ignoré.If bypassonlocal is set to any value, scriptLocation is ignored.

Utilisez le usesystemdefault attribut pour les applications .NET Framework version 1.1 qui effectuent une migration vers la version 2.0.Use the usesystemdefault attribute for .NET Framework version 1.1 applications that are migrating to version 2.0.

Une exception est levée si le proxyaddress attribut spécifie un proxy par défaut non valide.An exception is thrown if the proxyaddress attribute specifies an invalid default proxy. La propriété InnerException de l'exception fournit normalement plus d'informations sur la cause première de l'erreur.The InnerException property on the exception should have more information about the root cause of the error.

Fichiers de configurationConfiguration Files

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).This element can be used in the application configuration file or the machine configuration file (Machine.config).

ExempleExample

L’exemple suivant utilise les valeurs par défaut du proxy Internet Explorer, spécifie l’adresse de proxy et contourne le proxy pour l’accès local.The following example uses the defaults from the Internet Explorer proxy, specifies the proxy address, and bypasses the proxy for local access.

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

Voir aussiSee also