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

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

<configuration><configuration>
  <system.net>  <system.net>
    <défautProxy>    <defaultProxy>
      <>par procuration      <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 localeshttp://localhostcomprennent http://loopbackle http://127.0.0.1serveur local ( ,http://webserver, ou ) et un URI sans période ( ).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 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 bypassonlocal pas l’attribut avec cet attribut.Do not use the bypassonlocal attribute with this attribute.
usesystemdefault Précise s’il faut utiliser les paramètres de proxy Internet Explorer.Specifies whether to use Internet Explorer proxy settings. Si défini trueà , attributs ultérieurs remplacera 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

Notes Remarks

L’élément proxy définit un serveur proxy pour une application.The proxy element defines a proxy server for an application. Si cet élément est absent du fichier de configuration, alors le cadre .NET utilisera les paramètres 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 proxyaddress de l’attribut devrait être un indicateur uniforme bien formé des ressources (URI).The value for the proxyaddress attribute should be a well-formed Uniform Resource Indicator (URI).

L’attribut scriptLocation se réfère à la détection automatique des scripts de configuration proxy.The scriptLocation attribute refers to the automatic detection of proxy configuration scripts. La WebProxy classe tentera de localiser un script de configuration (généralement appelé Wpad.dat) lorsque l’option de script de configuration automatique Utiliser 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 réglé à scriptLocation une valeur quelconque, est ignoré.If bypassonlocal is set to any value, scriptLocation is ignored.

Utilisez usesystemdefault l’attribut pour les applications .NET Framework version 1.1 qui migrent 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 proxyaddress lancée si l’attribut spécifie un proxy par défaut invalide.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 défauts du proxy Internet Explorer, spécifie l’adresse 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