Compartir a través de

<defaultProxy> elemento (configuración de red)

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

<configuration><system.net><defaultProxy>

Nota:

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

Syntax

<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.

Attributes

Elemento Descripción
enabled Especifica si se usa un proxy web. El valor predeterminado es True.
useDefaultCredentials Especifica si las credenciales predeterminadas para este host se usan para acceder al proxy web. El valor predeterminado es False.

Elementos secundarios

Elemento 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

Elemento Descripción
system.net Contiene la configuración que especifica cómo se conecta .NET Framework a la red.

Observaciones

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

Se produce una excepción si el elemento de módulo especifica un tipo no público, el tipo no deriva de la IWebProxy clase , una excepción del constructor sin parámetros de este objeto o se produjo una excepción al recuperar el proxy predeterminado especificado por el sistema. La InnerException propiedad de la excepción debe tener más información sobre 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 de la máquina (Machine.config).

Example

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 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

  • Last updated on