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

아티클
03/30/2023

프록시 서버를 정의합니다.

<configuration>
  <system.net>
    <defaultProxy>
      <proxy>

구문

<proxy
  autoDetect="True|False|Unspecified"
  bypassonlocal="True|False|Unspecified"
  proxyaddress="uriString"
  scriptLocation="uriString"
  usesystemdefault="True|False|Unspecified"
/>

특성 및 요소

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

특성

Attribute	설명
`autoDetect`	프록시를 자동으로 검색할지 여부를 지정합니다. 기본값은 `Unspecified`입니다.
`bypassonlocal`	로컬 리소스에 프록시가 사용되지 않는지 여부를 지정합니다. 로컬 리소스는 로컬 서버(`http://localhost`, `http://loopback` 또는 `http://127.0.0.1`) 및 마침표가 없는 URI(`http://webserver`)를 포함합니다. 기본값은 `Unspecified`입니다.
`proxyaddress`	사용할 프록시 URI를 지정합니다.
`scriptLocation`	구성 스크립트의 위치를 지정합니다. 이 특성에는 `bypassonlocal` 특성을 사용하지 마세요.
`usesystemdefault`	시스템 프록시 설정을 사용할지 여부를 지정합니다. 로 `True`설정하면 후속 특성이 시스템 프록시 설정을 재정의합니다. 기본값은 `Unspecified`입니다.

자식 요소

없음

부모 요소

요소	설명
defaultProxy	HTTP(Hypertext Transfer Protocol) 프록시 서버를 구성합니다.

텍스트 값

설명

proxy 요소는 애플리케이션에 대한 프록시 서버를 정의합니다. 이 요소가 구성 파일에서 누락된 경우 .NET Framework 시스템 프록시 설정을 사용합니다.

proxyaddress 특성 값은 올바른 형식의 URI(Uniform Resource Indicator)여야 합니다.

scriptLocation 특성은 프록시 구성 스크립트의 자동 검색을 나타냅니다. 클래스는 WebProxy 인터넷 속성에서 연결에 대해 자동 구성 스크립트 사용 옵션을 선택하면 구성 스크립트(일반적으로 Wpad.dat)를 찾으려고 시도합니다. bypassonlocal이 임의 값으로 설정된 경우 scriptLocation은 무시됩니다.

proxyaddress 특성이 잘못된 기본 프록시를 지정하는 경우 예외가 throw됩니다. 예외의 InnerException 속성에는 오류의 근본 원인에 대한 추가 정보가 있어야 합니다.

구성 파일

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

예제

다음 예제에서는 시스템 프록시의 기본값을 사용하고, 프록시 주소를 지정하고, 로컬 액세스를 위해 프록시를 바이패스합니다.

<configuration>  
  <system.net>  
    <defaultProxy>  
      <proxy  
        usesystemdefault="True"  
        proxyaddress="http://192.168.1.10:3128"  
        bypassonlocal="True"  
      />  
    </defaultProxy>  
  </system.net>  
</configuration>