WinHttpHandler 클래스

정의

네임스페이스:

System.Net.Http

어셈블리:

System.Net.Http.WinHttpHandler.dll

패키지:

System.Net.Http.WinHttpHandler v8.0.0

Source:

WinHttpHandler.cs

Windows의 WinHTTP 인터페이스에 따라 메시지를 처리합니다. 이 클래스는 서버 환경에서 사용하기 위한 것입니다.

public ref class WinHttpHandler : System::Net::Http::HttpMessageHandler

public class WinHttpHandler : System.Net.Http.HttpMessageHandler

type WinHttpHandler = class
    inherit HttpMessageHandler

Public Class WinHttpHandler
Inherits HttpMessageHandler

상속

Object

HttpMessageHandler

WinHttpHandler

설명

WinHttpHandler 는 와 같은 HttpClientHandler다른 기존 클래스와 유사합니다. WinHttpHandler는 instance 아래에 HttpClient 처리기를 제공하며 HTTP 요청을 서버로 보내고 서버 응답을 받는 데 사용됩니다. 구현은 WinHttpHandler HTTP/2까지 HTTP 버전을 지원합니다.

WinHttpHandler ASP.NET Core 및 HTTP 서버와 통신 하는 다른.NET 애플리케이션에서 사용할 서버 환경에서 주로 하도록 설계 되었습니다. WinHttpHandler 또한 애플리케이션의 HTTP 통신 보다 더 세부적으로 제어를 사용 하 여 개발자에 게 제공 된 HttpClientHandler 클래스입니다. 이를 통해 개발자는 고급 HTTP 시나리오를 구현하거나 시스템 기본값(예: 프록시 설정, 시간 제한 및 서버 SSL 인증서 유효성 검사)을 수정할 수 있습니다.

WinHttpHandler 은(는) 대신 HttpClientHandler사용할 수 없습니다. 대신 가 부족한 시나리오 HttpClientHandler 에 제공되는 고급 버전입니다. WinHttpHandler 는 Windows의 WinHTTP 인터페이스에서 씬 래퍼로 구현되며 Windows 시스템에서만 지원됩니다.

여러 처리기의 체인을 사용하는 경우 는 WinHttpHandler 체인의 맨 아래에 있어야 합니다.

이 클래스는 NuGet 패키지로 설치하여 데스크톱 앱에도 사용할 수 있습니다. 자세한 내용은 System.Net.Http.WinHttpHandler NuGet 패키지를 참조하세요.

.NET 5 WinHttpHandler 부터 는 더 이상 .NET 런타임의 일부로 System.Net.Http.dll 어셈블리에 포함되지 않습니다. 자세한 내용은 .NET 런타임에서 제거된 WinHttpHandler를 참조하세요.

생성자

WinHttpHandler()

WinHttpHandler 클래스의 새 인스턴스를 초기화합니다.

속성

AutomaticDecompression	HTTP 콘텐츠 응답의 자동 압축 풀기를 위해 처리기가 사용하는 압축 풀기 메서드 형식을 가져오거나 설정합니다.
AutomaticRedirection	처리기가 HTTP 리디렉션 응답을 따르는지 여부를 나타내는 값을 가져오거나 설정합니다.
CheckCertificateRevocationList	SSL 인증서 유효성 검사 중에 인증서 해지 목록을 확인하는지 여부를 나타내는 값을 가져오거나 설정합니다.
ClientCertificateOption	인증서가 인증서 저장소에서 자동으로 선택되는지 또는 호출자가 특정 클라이언트 인증서에 전달하도록 허용되는지를 나타내는 값을 가져오거나 설정합니다.
ClientCertificates	ClientCertificateOption 속성이 Manual로 설정된 경우 처리기가 클라이언트 인증에 사용하는 클라이언트 인증 SSL 인증서 컬렉션을 가져옵니다.
CookieContainer	관리되는 쿠키 컨테이너 개체를 가져오거나 설정합니다. 이 속성은 CookieUsePolicy 속성이 UseSpecifiedCookieContainer로 설정된 경우에만 사용됩니다. 그렇지 않으면 SendAsync(HttpRequestMessage, CancellationToken) 메서드는 예외를 throw합니다.
CookieUsePolicy	쿠키가 관리 및 사용되는 방식을 나타내는 값을 가져오거나 설정합니다. 개발자는 쿠키를 무시하고 처리기가 자동으로 관리하거나 CookieContainer 개체를 사용하여 수동으로 처리하도록 선택할 수 있습니다.
DefaultProxyCredentials	프록시를 인증할 사용자를 인증하는 데 사용되는 자격 증명을 가져오거나 설정합니다.
EnableMultipleHttp2Connections	모든 기존 연결에서 최대 동시 스트림 수에 도달할 경우 동일한 서버에 추가 HTTP/2 연결을 설정할 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다.
MaxAutomaticRedirections	허용되는 HTTP 리디렉션의 최대 수를 가져오거나 설정합니다.
MaxConnectionsPerServer	단일 서버에서 허용하는 최대 TCP 연결 수를 가져오거나 설정합니다.
MaxResponseDrainSize	응답에서 배출할 수 있는 최대 데이터 양을 바이트 단위로 가져오거나 설정합니다.
MaxResponseHeadersLength	서버 응답에서 헤더 부분의 최대 크기를 바이트 단위로 가져오거나 설정합니다.
PreAuthenticate	처리기가 요청과 함께 인증 헤더를 보낼 것인지 여부를 나타내는 값을 가져오거나 설정합니다.
Properties	HttpClient 요청에 대해 사용자 지정 속성의 쓰기 가능한 사전(즉, 맵)을 가져옵니다. 사전이 비어 있도록 초기화되었습니다. 사용자 지정 처리기 및 특수한 처리에 대한 키-값 쌍을 삽입하고 쿼리할 수 있습니다.
Proxy	WindowsProxyUsePolicy 속성이 사용자 지정 프록시를 사용하도록 설정된 경우 사용자 지정 프록시를 가져오거나 설정합니다.
ReceiveDataTimeout	서버에서 응답의 데이터 부분을 수신하기 위한 시간 제한을 가져오거나 설정합니다.
ReceiveHeadersTimeout	서버에서 응답의 헤더를 수신하기 위한 시간 제한을 가져오거나 설정합니다.
SendTimeout	요청을 보내기 위한 시간 제한을 가져오거나 설정합니다.
ServerCertificateValidationCallback	서버 인증서의 유효성을 검사할 콜백 메서드를 가져오거나 설정합니다. 이 콜백은 SSL 핸드셰이크의 일부입니다.
ServerCredentials	서버에 대해 클라이언트를 인증할 때 사용되는 자격 증명을 가져오거나 설정합니다.
SslProtocols	클라이언트에서 지원되는 TLS/SSL 프로토콜의 컬렉션을 가져오거나 설정합니다.
TcpKeepAliveEnabled	TCP 연결 유지를 사용할 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다.
TcpKeepAliveInterval	TCP 연결 유지 간격을 가져오거나 설정합니다.
TcpKeepAliveTime	TCP 연결 유지 시간 제한을 가져오거나 설정합니다.
WindowsProxyUsePolicy	프록시 설정을 가져오거나 설정합니다. 이 속성은 프록시를 사용하지 않도록 설정하거나, 사용자 지정 프록시를 사용하거나, 컴퓨터에서 WinHTTP 또는 WinInet의 프록시 설정을 사용하도록 설정할 수 있습니다.

메서드

Dispose()	관리되지 않는 리소스를 해제하고, HttpMessageHandler에서 사용하는 관리되는 리소스를 삭제합니다. (다음에서 상속됨 HttpMessageHandler)
Dispose(Boolean)	WinHttpHandler에서 사용하는 관리되지 않는 리소스를 해제하고, 관리되는 리소스를 선택적으로 삭제할 수 있습니다.
Equals(Object)	지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object)
GetHashCode()	기본 해시 함수로 작동합니다. (다음에서 상속됨 Object)
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
Send(HttpRequestMessage, CancellationToken)	파생 클래스에서 재정의된 경우 지정된 요청 및 취소 토큰을 사용하여 HTTP 요청을 보냅니다. 그렇지 않으면 NotSupportedException이 throw됩니다. (다음에서 상속됨 HttpMessageHandler)
SendAsync(HttpRequestMessage, CancellationToken)	HTTP 요청을 비동기 작업으로 보냅니다.
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)