다음을 통해 공유

WebProxy 클래스

정의

네임스페이스:
System.Net
어셈블리:
netstandard.dll, System.Net.WebProxy.dll
어셈블리:
System.Net.WebProxy.dll
어셈블리:
System.dll
어셈블리:
netstandard.dll
Source:
WebProxy.cs
Source:
WebProxy.cs
Source:
WebProxy.cs
Source:
WebProxy.cs
Source:
WebProxy.cs

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

public ref class WebProxy : System::Net::IWebProxy, System::Runtime::Serialization::ISerializable
public ref class WebProxy : System::Runtime::Serialization::ISerializable
public class WebProxy : System.Net.IWebProxy, System.Runtime.Serialization.ISerializable
[System.Serializable]
public class WebProxy : System.Net.IWebProxy, System.Runtime.Serialization.ISerializable
[System.Serializable]
public class WebProxy : System.Runtime.Serialization.ISerializable
type WebProxy = class
    interface IWebProxy
    interface ISerializable
[<System.Serializable>]
type WebProxy = class
    interface IWebProxy
    interface ISerializable
Public Class WebProxy
Implements ISerializable, IWebProxy
Public Class WebProxy
Implements ISerializable
상속
Object
WebProxy
특성
SerializableAttribute
구현
IWebProxy ISerializable

예제

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

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 . 인스턴스 간의 차이점은 인스턴스가 애플리케이션에 반환되기 전에 초기화되는 방식입니다. WebProxy 생성자는 속성이 .로 설정된 클래스의 WebProxy 인스턴스를 Address 반환합니다null. 요청이 이 상태의 인스턴스를 WebProxy 사용하는 경우 요청을 보내는 데 프록시가 사용되지 않습니다.

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

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

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

생성자

Name Description
WebProxy()

클래스의 빈 인스턴스를 초기화합니다 WebProxy .
WebProxy(SerializationInfo, StreamingContext)
사용되지 않음.

이전에 직렬화된 콘텐츠를 사용하여 클래스의 WebProxy 인스턴스를 초기화합니다.
WebProxy(String, Boolean, String[], ICredentials)

지정된 URI, 바이패스 설정, 바이패스할 URI 목록 및 자격 증명을 사용하여 클래스의 새 인스턴스 WebProxy 를 초기화합니다.
WebProxy(String, Boolean, String[])

지정된 URI, 바이패스 설정 및 바이패스할 URI 목록을 사용하여 클래스의 새 인스턴스 WebProxy 를 초기화합니다.
WebProxy(String, Boolean)

지정된 URI 및 바이패스 설정을 사용하여 클래스의 WebProxy 새 인스턴스를 초기화합니다.
WebProxy(String, Int32)

지정된 호스트 및 포트 번호를 사용하여 클래스의 WebProxy 새 인스턴스를 초기화합니다.
WebProxy(String)

지정된 URI를 사용하여 클래스의 WebProxy 새 인스턴스를 초기화합니다.
WebProxy(Uri, Boolean, String[], ICredentials)

지정된 Uri 인스턴스, 바이패스 설정, 바이패스할 URI 목록 및 자격 증명을 사용하여 클래스의 새 인스턴스 WebProxy 를 초기화합니다.
WebProxy(Uri, Boolean, String[])

지정된 Uri 인스턴스WebProxy, 바이패스 설정 및 바이패스할 URI 목록을 사용하여 클래스의 새 인스턴스를 초기화합니다.
WebProxy(Uri, Boolean)

인스턴스 및 바이패스 설정을 사용하여 클래스의 WebProxy 새 인스턴스를 Uri 초기화합니다.
WebProxy(Uri)

지정된 Uri 인스턴스에서 클래스의 WebProxy 새 인스턴스를 초기화합니다.

속성

Name Description
Address

프록시 서버의 주소를 가져오거나 설정합니다.
BypassArrayList

프록시 서버를 사용하지 않는 주소 목록을 가져옵니다.
BypassList

프록시 서버를 사용하지 않는 주소 배열을 가져오거나 설정합니다.
BypassProxyOnLocal

로컬 주소에 대한 프록시 서버를 무시할지 여부를 나타내는 값을 가져오거나 설정합니다.
Credentials

인증을 위해 프록시 서버에 제출할 자격 증명을 가져오거나 설정합니다.
UseDefaultCredentials

요청과 함께 전송되는지 여부를 DefaultCredentials 제어하는 값을 가져오거나 설정합니다Boolean.

메서드

Name Description
Equals(Object)

지정된 개체가 현재 개체와 같은지 여부를 확인합니다.

(다음에서 상속됨 Object)
GetDefaultProxy()
사용되지 않음.
사용되지 않음.
사용되지 않음.

인터넷 옵션 비역학적 프록시 설정을 읽습니다.
GetHashCode()

기본 해시 함수로 사용됩니다.

(다음에서 상속됨 Object)
GetObjectData(SerializationInfo, StreamingContext)

대상 개체를 SerializationInfo serialize하는 데 필요한 데이터로 채웁니다.
GetProxy(Uri)

요청에 대한 프록시된 URI를 반환합니다.
GetType()

현재 인스턴스의 Type 가져옵니다.

(다음에서 상속됨 Object)
IsBypassed(Uri)

지정된 호스트에 프록시 서버를 사용할지 여부를 나타냅니다.
MemberwiseClone()

현재 Object단순 복사본을 만듭니다.

(다음에서 상속됨 Object)
ToString()

현재 개체를 나타내는 문자열을 반환합니다.

(다음에서 상속됨 Object)

명시적 인터페이스 구현

Name Description
ISerializable.GetObjectData(SerializationInfo, StreamingContext)

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

적용 대상