Partilhar via

<defaultProxy> elemento (definições de rede)

Configura o servidor proxy do Protocolo de Transferência de Hipertexto (HTTP).

<configuration>   <system.net>     <defaultProxy>

Observação

Se estás a migrar para .NET 6+, configura o servidor proxy usando a HttpClient.DefaultProxy propriedade.

Sintaxe

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

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Attributes

elemento Descrição
enabled Especifica se é utilizado um proxy web. O valor predefinido é True.
useDefaultCredentials Especifica se as credenciais padrão deste host são usadas para aceder ao proxy web. O valor predefinido é False.

Elementos filho

elemento Descrição
Bypasslist Fornece um conjunto de expressões regulares que descrevem endereços que não utilizam o proxy.
módulo Adiciona um novo módulo proxy à aplicação.
procuração Define um servidor proxy.

Elementos pai

elemento Descrição
system.net Contém definições que especificam como o .NET Framework se liga à rede.

Observações

Se o defaultProxy elemento estiver vazio, são usadas as definições do proxy do sistema.

É lançada uma exceção se o elemento do módulo especificar um tipo não público, se o tipo não derivar da IWebProxy classe, se ocorreu uma exceção do construtor sem parâmetros deste objeto, ou se ocorreu uma exceção ao recuperar o proxy padrão especificado pelo sistema. A InnerException propriedade na exceção deve conter mais informação sobre a causa raiz do erro.

Arquivos de configuração

Este elemento pode ser usado no ficheiro de configuração da aplicação ou no ficheiro de configuração da máquina (Machine.config).

Example

O exemplo seguinte utiliza os valores predefinidos do proxy do sistema, especifica o endereço do proxy e contorna o proxy para acesso local e 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 também

  • Last updated on