<Elemento >defaultProxy (configuración de red)

  • Artículo

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>

Consulte también