Compartir a través de


<proxy> (Elemento, Configuración de red)

Actualización: noviembre 2007

Define un servidor proxy.

<configuration> (Elemento)
  <system.Net> (Elemento, Configuración de red)
    <defaultProxy> (Elemento, Configuración de red)
      <proxy> (Elemento, Configuración de red)

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

Atributos y elementos

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.

Atributos

Atributo

Descripción

autoDetect

Especifica si el servidor proxy se detecta automáticamente. El valor predeterminado es unspecified.

bypassonlocal

Especifica si el servidor proxy se omite para los recursos locales. Entre los recursos locales se incluyen el servidor local (https://localhost, https://loopback o http://127.0.0.1) y un identificador uniforme de recursos (URI) sin punto (http://webserver). El valor predeterminado es unspecified.

proxyaddress

Especifica el URI del servidor proxy que se va a utilizar.

scriptLocation

Especifica la ubicación de la secuencia de comandos de configuración.

usesystemdefault

Especifica si se va a utilizar la configuración de proxy de Internet Explorer. Si se establece en true, los atributos subsiguientes reemplazarán la configuración de proxy de Internet Explorer. El valor predeterminado es unspecified.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento

Descripción

defaultProxy

Configura el servidor proxy de Protocolo de transferencia de hipertexto (HTTP).

Comentarios

El elemento proxy define un servidor proxy para una aplicación. Si este elemento no se encuentra en el archivo de configuración, .NET Framework utilizará la configuración de proxy de Internet Explorer.

El valor del atributo proxyaddress debe ser un identificador uniforme de recursos (URI) correcto.

El atributo scriptLocation hace referencia a la detección automática de secuencias de comandos de configuración de proxy. La clase WebProxy intentará localizar una secuencia de comandos de configuración (normalmente denominada Wpad.dat) cuando la opción Usar secuencia de comandos de configuración automática esté seleccionada en Internet Explorer.

Utilice el atributo usesystemdefault para las aplicaciones de la versión de 1.1 de .NET Framework que migren a la versión 2.0.

Archivos de configuración

Este elemento puede utilizarse en el archivo de configuración de la aplicación o en el archivo de configuración del equipo (Machine.config).

Ejemplo

En el siguiente ejemplo de código se utilizan los valores predeterminados del servidor proxy de Internet Explorer, se especifica la dirección del servidor proxy y se omite el servidor proxy para el acceso local.

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

Vea también

Referencia

Esquema de la configuración de red

System.Net.WebProxy