<proxy> Elemento (configuración de red)

  • Artículo

Define un servidor proxy.

<configuración>
  <system.net>
    <defaultProxy>
      <proxy>

Sintaxis

<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, los elementos secundarios y los 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. Los recursos locales incluyen el servidor local (http://localhost, http://loopbacko http://127.0.0.1) y un URI sin un punto (http://webserver). El valor predeterminado es Unspecified.
proxyaddress Especifica el URI de proxy que se va a usar.
scriptLocation Especifica la ubicación del script de configuración. No uses el atributo bypassonlocal con este atributo.
usesystemdefault Especifica si se debe usar la configuración de proxy del sistema. Si se establece en True, los atributos posteriores invalidarán la configuración del proxy del sistema. El valor predeterminado es Unspecified.

Elementos secundarios

Ninguno.

Elementos primarios

Element Descripción
defaultProxy Configura el servidor proxy de Protocolo de transferencia de hipertexto (HTTP).

Valor de texto

Comentarios

El elemento proxy define un servidor proxy para una aplicación. Si falta este elemento en el archivo de configuración, .NET Framework usará la configuración de proxy del sistema.

El valor del proxyaddress atributo debe ser un indicador uniforme de recursos (URI) bien formado.

El atributo scriptLocation hace referencia a la detección automática de scripts de configuración de proxy. La clase WebProxy intentará buscar un script de configuración (normalmente denominado Wpad.dat) cuando la opción Usar script de configuración automática esté seleccionada para la conexión en las propiedades de Internet. Este valor se omite si bypassonlocal está establecido en scriptLocation.

Se produce una excepción si el proxyaddress atributo especifica un proxy predeterminado no válido. La propiedad InnerException en la excepción debería tener más información acerca de la causa principal del error.

Archivos de configuración

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

Ejemplo

En el ejemplo siguiente se usan los valores predeterminados del proxy del sistema, se especifica la dirección del proxy y se omite el 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>

Consulte también