HttpClientHandler 클래스

정의

네임스페이스:

System.Net.Http

어셈블리:

netstandard.dll, System.Net.Http.dll

Source:

HttpClientHandler.cs

.NET Framework에서 사용하는 HttpClient 기본 메시지 처리기입니다.

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

public class HttpClientHandler : System.Net.Http.HttpMessageHandler

type HttpClientHandler = class
    inherit HttpMessageHandler

Public Class HttpClientHandler
Inherits HttpMessageHandler

상속

Object

HttpMessageHandler

HttpClientHandler

파생

System.Net.Http.WebRequestHandler

예제

static async Task Main()
{
   // Create an HttpClientHandler object and set to use default credentials
   HttpClientHandler handler = new HttpClientHandler();
   handler.UseDefaultCredentials = true;

   // Create an HttpClient object
   HttpClient client = new HttpClient(handler);

   // Call asynchronous network methods in a try/catch block to handle exceptions
   try
   {
      HttpResponseMessage response = await client.GetAsync("http://www.contoso.com/");

      response.EnsureSuccessStatusCode();

      string responseBody = await response.Content.ReadAsStringAsync();
      Console.WriteLine(responseBody);
   }
   catch(HttpRequestException e)
   {
       Console.WriteLine("\nException Caught!");
       Console.WriteLine("Message :{0} ",e.Message);
   }

   // Need to call dispose on the HttpClient and HttpClientHandler objects
   // when done using them, so the app doesn't leak resources
   handler.Dispose();
   client.Dispose();
}

설명

이 API에 대한 자세한 내용은 HttpClientHandler에 대한 추가 API 비고를 참조하세요.

생성자

Name	Description
HttpClientHandler()	클래스의 인스턴스를 HttpClientHandler 만듭니다.

속성

Name	Description
AllowAutoRedirect	처리기가 리디렉션 응답을 따라야 하는지 여부를 나타내는 값을 가져오거나 설정합니다.
AutomaticDecompression	HTTP 콘텐츠 응답의 자동 압축 해제를 위해 처리기에서 사용하는 압축 해제 메서드의 형식을 가져오거나 설정합니다.
CheckCertificateRevocationList	인증서가 인증 기관 해지 목록에 대해 검사되는지 여부를 나타내는 값을 가져오거나 설정합니다.
ClientCertificateOptions	인증서가 인증서 저장소에서 자동으로 선택되는지 또는 호출자가 특정 클라이언트 인증서를 전달할 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다.
ClientCertificates	서버에 대한 요청과 연결된 보안 인증서의 컬렉션을 가져옵니다.
CookieContainer	처리기에서 서버 쿠키를 저장하는 데 사용되는 쿠키 컨테이너를 가져오거나 설정합니다.
Credentials	이 처리기에서 사용하는 인증 정보를 가져오거나 설정합니다.
DangerousAcceptAnyServerCertificateValidator	항상 반환하는 캐시된 대리자를 가져옵니다 true.
DefaultProxyCredentials	기본(시스템) 프록시를 사용하는 경우 인증을 위해 기본 프록시 서버에 제출할 자격 증명을 가져오거나 설정합니다. 기본 프록시는 설정되고 Proxy 로 설정된 nulltrue 경우에만 UseProxy 사용됩니다.
MaxAutomaticRedirections	처리기가 따르는 최대 리디렉션 수를 가져오거나 설정합니다.
MaxConnectionsPerServer	개체를 사용하여 HttpClient 요청할 때 허용되는 최대 동시 연결 수(서버 엔드포인트당)를 가져오거나 설정합니다. 제한은 서버 엔드포인트당이므로 예를 들어 값이 256이면 256개의 동시 연결과 256개의 http://www.adatum.com/ 동시 연결이 허용됩니다 http://www.adventure-works.com/.
MaxRequestContentBufferSize	처리기에서 사용하는 최대 요청 콘텐츠 버퍼 크기를 가져오거나 설정합니다.
MaxResponseHeadersLength	응답 헤더의 최대 길이(킬로바이트(1024바이트)를 가져오거나 설정합니다. 예를 들어 값이 64이면 최대 응답 헤더 길이에 대해 65536바이트가 허용됩니다.
MeterFactory	인스턴스에 IMeterFactory 대한 HttpClientHandler 사용자 지정 Meter 을 만들려는 사용자를 가져오거나 설정합니다.
PreAuthenticate	처리기가 요청과 함께 Authorization 헤더를 보내는지 여부를 나타내는 값을 가져오거나 설정합니다.
Properties	요청에 대한 사용자 지정 속성의 쓰기 가능한 사전(즉, 맵)을 HttpClient 가져옵니다. 사전은 비어 초기화됩니다. 사용자 지정 처리기 및 특수 처리에 대한 키-값 쌍을 삽입하고 쿼리할 수 있습니다.
Proxy	처리기에서 사용하는 프록시 정보를 가져오거나 설정합니다.
ServerCertificateCustomValidationCallback	서버 인증서의 유효성을 검사하는 콜백 메서드를 가져오거나 설정합니다.
SslProtocols	HttpClientHandler 개체에서 관리하는 개체에서 HttpClient 사용하는 TLS/SSL 프로토콜을 가져오거나 설정합니다.
SupportsAutomaticDecompression	처리기가 자동 응답 콘텐츠 압축 해제를 지원하는지 여부를 나타내는 값을 가져옵니다.
SupportsProxy	처리기가 프록시 설정을 지원하는지 여부를 나타내는 값을 가져옵니다.
SupportsRedirectConfiguration	처리기가 및 MaxAutomaticRedirections 속성에 대한 AllowAutoRedirect 구성 설정을 지원하는지 여부를 나타내는 값을 가져옵니다.
UseCookies	처리기가 이 속성을 사용하여 CookieContainer 서버 쿠키를 저장하고 요청을 보낼 때 이러한 쿠키를 사용하는지 여부를 나타내는 값을 가져오거나 설정합니다.
UseDefaultCredentials	처리기의 요청과 함께 기본 자격 증명을 보낼지 여부를 제어하는 값을 가져오거나 설정합니다.
UseProxy	처리기가 요청에 프록시를 사용하는지 여부를 나타내는 값을 가져오거나 설정합니다.

메서드

Name	Description
Dispose()	관리되지 않는 리소스를 해제하고 관리되는 리소스를 삭제합니다 HttpMessageHandler. (다음에서 상속됨 HttpMessageHandler)
Dispose(Boolean)	관리되는 리소스에 사용되는 관리되지 않는 리소스를 HttpClientHandler 해제하고 필요에 따라 관리되는 리소스를 삭제합니다.
Equals(Object)	지정된 개체가 현재 개체와 같은지 여부를 확인합니다. (다음에서 상속됨 Object)
GetHashCode()	기본 해시 함수로 사용됩니다. (다음에서 상속됨 Object)
GetType()	현재 인스턴스의 Type 가져옵니다. (다음에서 상속됨 Object)
MemberwiseClone()	현재 Object단순 복사본을 만듭니다. (다음에서 상속됨 Object)
Send(HttpRequestMessage, CancellationToken)	에 제공된 정보를 기반으로 인스턴스 HttpResponseMessage 를 HttpRequestMessage만듭니다.
SendAsync(HttpRequestMessage, CancellationToken)	HttpResponseMessage 차단되지 않는 작업으로 제공된 HttpRequestMessage 정보를 기반으로 인스턴스를 만듭니다.
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)

추가 정보

• 웹 서비스에 연결
• 빠른 시작: HttpClient를 사용하여 연결
• HttpClient 처리기를 사용하는 방법
• HttpClient 연결을 보호하는 방법