HttpClientHandler 클래스

정의

네임스페이스:

System.Net.Http

어셈블리:

System.Net.Http.dll

Source:

HttpClientHandler.cs

.NET Framework 및.NET Core 2.0 이전 버전의 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 설명을 참조하세요.

생성자

HttpClientHandler()

HttpClientHandler 클래스의 인스턴스를 만듭니다.

속성

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

메서드

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

추가 정보

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