<Elemento >defaultProxy (configuración de red)

Artículo
08/17/2023

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

<configuration><system.net><defaultProxy>

Nota

Si va a migrar a .NET 6+, configure el servidor proxy mediante la propiedad HttpClient.DefaultProxy.

Sintaxis

<defaultProxy
  enabled="True|False"
  useDefaultCredentials="True|False">
    <bypasslist>...</bypasslist>
    <proxy>...</proxy>
    <module>...</module>
</defaultProxy>

Atributos y elementos

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

Atributos

Element	Descripción
`enabled`	Especifica si se usa un proxy web. El valor predeterminado es `True`.
`useDefaultCredentials`	Especifica si se usan las credenciales predeterminadas de este host para tener acceso al proxy web. El valor predeterminado es `False`.

Elementos secundarios

Element	Descripción
bypasslist	Proporciona un conjunto de expresiones regulares que describen direcciones que no usan el proxy.
module	Agrega un nuevo módulo proxy a la aplicación.
proxy	Define un servidor proxy.

Elementos primarios

Element	Descripción
system.net	Contiene valores que especifican cómo se conecta .NET Framework a la red.

Comentarios

Si el elemento defaultProxy está vacío, se usa la configuración del proxy del sistema.

Se produce una excepción si el elemento module especifica un tipo no público, el tipo no deriva de la clase IWebProxy, se produjo una excepción en el constructor sin parámetro de este objeto o se produjo una excepción al recuperar el proxy predeterminado especificado por el sistema. 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 y para contoso.com.

<configuration>
  <system.net>
    <defaultProxy>
      <proxy
        usesystemdefault="True"
        proxyaddress="http://192.168.1.10:3128"
        bypassonlocal="True"
      />
      <bypasslist>
        <add address="[a-z]+\.contoso\.com$" />
      </bypasslist>
    </defaultProxy>
  </system.net>
</configuration>

Compartir a través de