WebProxy 클래스

정의

네임스페이스:

System.Net

어셈블리:

System.Net.WebProxy.dll

Source:

WebProxy.cs

HttpClient 클래스에 대해 HTTP 프록시 설정을 포함합니다.

public ref class WebProxy : System::Net::IWebProxy, System::Runtime::Serialization::ISerializable

public class WebProxy : System.Net.IWebProxy, System.Runtime.Serialization.ISerializable

type WebProxy = class
    interface IWebProxy
    interface ISerializable

Public Class WebProxy
Implements ISerializable, IWebProxy

상속

Object

WebProxy

구현

IWebProxy ISerializable

예제

다음 코드 예제에서는 인스턴스를 사용하여 HttpClient 인스턴스를 WebProxy 설정합니다. 인스턴스는 HttpClient 프록시를 사용하여 외부 인터넷 리소스에 연결합니다. (WPAD 기능을 사용하는 방법을 보여 주는 예제는 클래스에 대한 IWebProxyScript 설명서를 참조하세요.)

WebProxy^ proxyObject = gcnew WebProxy("http://proxyserver:80/", true);

// HttpClient lifecycle management best practices:
// https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
HttpClientHandler^ handler = gcnew HttpClientHandler();
handler->Proxy = proxyObject;
HttpClient^ client = gcnew HttpClient(handler);

WebProxy proxyObject = new WebProxy("http://proxyserver:80/", true);

// HttpClient lifecycle management best practices:
// https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
HttpClient client = new HttpClient(new HttpClientHandler
{
    Proxy = proxyObject
});

Dim proxyObject As New WebProxy("http://proxyserver:80/", True)

' HttpClient lifecycle management best practices:
' https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
Dim client As New HttpClient(New HttpClientHandler With
{
    .Proxy = proxyObject
})

설명

클래스에는 WebProxy 인스턴스가 웹 프록시를 HttpClient 사용하여 요청을 보내는 데 사용되는지 여부를 확인하는 데 사용하는 프록시 설정이 포함되어 있습니다. 컴퓨터 및 애플리케이션 구성 파일을 애플리케이션 프록시 설정을 지정할 수 있습니다 하는 글로벌 웹 인스턴스를 사용할 수는 WebProxy 웹 프록시 사용 하 여 사용자 지정 하는 클래스입니다. 클래스는 WebProxy 인터페이스의 기본 구현입니다 IWebProxy .

웹 프록시 클래스의 인스턴스를 가져오려면 다음 방법 중 원하는 방법을 사용할 수 있습니다.

• 생성자입니다 WebProxy .

• GetDefaultProxy 메서드

• Select 메서드

이러한 각 메서드는 WebProxy 수행할 수 있습니다. 인스턴스를 사용자 지정; 차이점은 애플리케이션에 반환 되기 전에 인스턴스가 초기화 되는 방법입니다. WebProxy 생성자는 속성이 WebProxy 로 설정된 클래스 Address 의 인스턴스를 반환합니다null. 요청이 이 상태의 인스턴스를 WebProxy 사용하는 경우 요청을 보내는 데 프록시가 사용되지 않습니다.

메서드는 GetDefaultProxy , BypassProxyOnLocal및 BypassList 속성이 로컬 컴퓨터에서 AddressWebProxy 사용하는 값으로 설정된 클래스의 인스턴스를 반환합니다.

메서드는 Select 인터넷 및 구성 파일 설정의 조합에 WebProxy 따라 설정 된 속성을 사용 하 여 클래스의 인스턴스를 반환 합니다.

클래스는 WebProxy 프록시 구성 스크립트의 자동 검색 및 실행을 지원합니다. 이 기능을 WPAD(웹 프록시 자동 검색)라고도 합니다. 자동 프록시 구성을 사용하는 경우 일반적으로 Wpad.dat 라는 구성 스크립트를 찾아 다운로드, 컴파일 및 실행해야 합니다. 이러한 작업이 성공하면 스크립트는 요청에 사용할 수 있는 프록시를 반환합니다.

생성자

WebProxy()	WebProxy 클래스의 빈 인스턴스를 초기화합니다.
WebProxy(SerializationInfo, StreamingContext)	사용되지 않음. 이전에 serialize된 내용을 사용하여 WebProxy 클래스의 인스턴스를 초기화합니다.
WebProxy(String)	URI가 지정된 WebProxy 클래스의 새 인스턴스를 초기화합니다.
WebProxy(String, Boolean)	지정된 URI와 사용 안 함 설정을 사용하여 WebProxy 클래스의 새 인스턴스를 초기화합니다.
WebProxy(String, Boolean, String[])	지정된 URI, 사용 안 함 설정 및 사용하지 않을 URI 목록을 사용하여 WebProxy 클래스의 새 인스턴스를 초기화합니다.
WebProxy(String, Boolean, String[], ICredentials)	지정된 URI, 사용 안 함 설정, 사용하지 않을 URI 목록 및 자격 증명을 사용하여 WebProxy 클래스의 새 인스턴스를 초기화합니다.
WebProxy(String, Int32)	지정된 호스트와 포트 번호를 사용하여 WebProxy 클래스의 새 인스턴스를 초기화합니다.
WebProxy(Uri)	지정된 WebProxy 인스턴스에서 Uri클래스의 새 인스턴스를 초기화합니다.
WebProxy(Uri, Boolean)	WebProxy 인스턴스와 사용 안 함 설정을 사용하여 Uri 클래스의 새 인스턴스를 초기화합니다.
WebProxy(Uri, Boolean, String[])	지정된 WebProxy 인스턴스, 사용 안 함 설정 및 사용하지 않을 URI 목록을 사용하여 Uri 클래스의 새 인스턴스를 초기화합니다.
WebProxy(Uri, Boolean, String[], ICredentials)	지정된 WebProxy 인스턴스, 사용 안 함 설정, 사용하지 않을 URI 목록 및 자격 증명을 사용하여 Uri 클래스의 새 인스턴스를 초기화합니다.

속성

Address	프록시 서버의 주소를 가져오거나 설정합니다.
BypassArrayList	프록시 서버를 사용하지 않는 주소 목록을 가져옵니다.
BypassList	프록시 서버를 사용하지 않는 주소의 배열을 가져오거나 설정합니다.
BypassProxyOnLocal	프록시 서버를 우회하고 로컬 주소를 대신 사용할지 여부를 나타내는 값을 가져오거나 설정합니다.
Credentials	인증을 위해 프록시 서버에 제출할 자격 증명을 가져오거나 설정합니다.
UseDefaultCredentials	요청에 Boolean을 보낼지 여부를 제어하는 DefaultCredentials 값을 가져오거나 설정합니다.

메서드

Equals(Object)	지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object)
GetDefaultProxy()	사용되지 않음. 인터넷 옵션 비역학적 프록시 설정을 읽습니다.
GetHashCode()	기본 해시 함수로 작동합니다. (다음에서 상속됨 Object)
GetObjectData(SerializationInfo, StreamingContext)	대상 개체를 serialize하는 데 필요한 데이터로 SerializationInfo를 채웁니다.
GetProxy(Uri)	요청에 대한 프록시된 URI를 반환합니다.
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
IsBypassed(Uri)	지정된 호스트에 프록시 서버를 사용할지 여부를 나타냅니다.
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)

명시적 인터페이스 구현

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

시스템에서 WebProxy 개체를 serialize하는 데 사용하는 serialization 데이터 및 컨텍스트를 만듭니다.