HttpClient.DefaultProxy 속성

정의

네임스페이스:

System.Net.Http

어셈블리:

netstandard.dll, System.Net.Http.dll

Source:

HttpClient.cs

전역 HTTP 프록시를 가져오거나 설정합니다.

public:
 static property System::Net::IWebProxy ^ DefaultProxy { System::Net::IWebProxy ^ get(); void set(System::Net::IWebProxy ^ value); };

public static System.Net.IWebProxy DefaultProxy { get; set; }

static member DefaultProxy : System.Net.IWebProxy with get, set

Public Shared Property DefaultProxy As IWebProxy

속성 값

IWebProxy

모든 HTTP 요청에서 사용되는 프록시입니다.

예외

ArgumentNullException

전달된 값은 을(를) 사용할 null수 없습니다.

설명

이 정적 속성은 전달된 생성자에서 명시적으로 설정된 프록시가 없는 경우 모든 HttpClient 인스턴스에서 HttpMessageHandler 사용하는 기본 프록시를 결정합니다.

이 속성에서 반환되는 기본 인스턴스는 플랫폼에 따라 다른 규칙 집합에 따라 초기화됩니다.

• Windows: 환경 변수에서 프록시 구성을 읽거나, 정의되지 않은 경우 사용자의 프록시 설정에서 프록시 구성을 읽습니다.

• macOS의 경우: 환경 변수에서 프록시 구성을 읽거나 정의되지 않은 경우 시스템의 프록시 설정에서 읽습니다.

• Linux의 경우: 환경 변수에서 프록시 구성을 읽거나 정의되지 않은 경우 이 속성은 모든 주소를 우회하는 구성되지 않은 인스턴스를 초기화합니다.

Windows 및 Unix 기반 플랫폼에서 DefaultProxy 초기화에 사용되는 환경 변수는 다음과 같습니다.

• HTTP_PROXY: HTTP 요청에 사용되는 프록시 서버입니다.
• HTTPS_PROXY: HTTPS 요청에 사용되는 프록시 서버입니다.
• ALL_PROXY: HTTP_PROXY 및/또는 HTTPS_PROXY 정의되지 않은 경우 HTTP 및/또는 HTTPS 요청에 사용되는 프록시 서버입니다.
• NO_PROXY: 프록시에서 제외해야 하는 쉼표로 구분된 호스트 이름 목록입니다. 와일드카드에는 별표가 지원되지 않습니다. 하위 도메인과 일치하려는 경우 선행 점을 사용합니다. 예: NO_PROXY=.example.com (선행 점 포함)은 일치하지만 일치하지 www.example.comexample.com않습니다. NO_PROXY=example.com (선행 점 없음)이 일치하지 www.example.com않습니다. 이 동작은 나중에 다른 에코시스템과 더 잘 일치하도록 다시 검토될 수 있습니다.

환경 변수가 대/소문자를 구분하는 시스템에서 변수 이름은 모두 소문자 또는 모든 대문자일 수 있습니다. 소문자 이름이 먼저 확인됩니다.

프록시 서버는 호스트 이름 또는 IP 주소일 수 있으며, 필요에 따라 콜론 및 포트 번호가 뒤따를 수도 있고, , , socks4ahttpssocks4또는 socks5 URL일 http수도 있습니다. URL은 호스트 이름, IP 또는 포트 뒤의 텍스트를 포함할 수 없습니다. 구성표가 지정되지 http 않은 경우 가정합니다. URL은 필요에 따라 프록시 인증을 위한 사용자 이름 및 암호를 포함할 수 있지만 프로토콜에서 암호 인증을 지원하지 않거나 사용할 socks4socks4a 때 암호가 무시됩니다.

• http: http://[username:password@]hostname[:port]
• https: https://[username:password@]hostname[:port]
• socks4: socks4://[username@]hostname[:port]
• socks4a: socks4a://[username@]hostname[:port]
• socks5: socks5://[username:password@]hostname[:port]