<defaultProxy> 요소(네트워크 설정)

아티클
08/15/2023

HTTP(Hypertext Transfer Protocol) 프록시 서버를 구성합니다.

<configuration><system.net<>defaultProxy>

참고 항목

.NET 6 이상으로 마이그레이션하는 경우 속성을 사용하여 프록시 서버를 구성합니다 HttpClient.DefaultProxy .

구문

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

특성 및 요소

다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.

특성

요소	Description
`enabled`	웹 프록시의 사용 여부를 지정합니다. 기본값은 `True`입니다.
`useDefaultCredentials`	이 호스트에 대한 기본 자격 증명을 사용하여 웹 프록시에 액세스하는지 여부를 지정합니다. 기본값은 `False`입니다.

자식 요소

요소	Description
바이패스 목록	프록시를 사용하지 않는 주소를 설명하는 정규식 집합을 제공합니다.
module	애플리케이션에 새 프록시 모듈을 추가합니다.
프록시	프록시 서버를 정의합니다.

부모 요소

요소	Description
system.net	.NET Framework가 네트워크에 연결하는 방법을 지정하는 설정을 포함합니다.

설명

defaultProxy 요소가 비어 있으면 시스템 프록시 설정이 사용됩니다.

module 요소가 public이 아닌 형식을 지정하거나, 형식이 IWebProxy 클래스에서 파생되지 않거나, 이 개체의 매개 변수가 없는 생성자에서 예외가 발생했거나, 시스템 지정 기본 프록시를 검색하는 동안 예외가 발생한 경우 예외가 throw됩니다. 예외의 InnerException 속성에는 오류의 근본 원인에 대한 추가 정보가 있어야 합니다.

구성 파일

이 요소는 애플리케이션 구성 파일 또는 컴퓨터 구성 파일(Machine.config)에서 사용할 수 있습니다.

예

다음 예제에서는 시스템 프록시의 기본값을 사용하고 프록시 주소를 지정하며 로컬 액세스 및 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>