<proxy> Elemento (configuración de red)

Artículo
04/03/2023

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://loopback`o `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>

Compartir a través de