다음을 통해 공유


HttpClientHandler 클래스

정의

.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
상속
HttpClientHandler
파생

예제

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

기본(시스템) 프록시를 사용하는 경우 인증을 위해 기본 프록시 서버에 제출하기 위해 자격 증명을 가져오거나 설정합니다. 기본 프록시는 UseProxytrue로 설정되고 Proxynull로 설정된 경우에만 사용됩니다.

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

처리기에서 AllowAutoRedirectMaxAutomaticRedirections 속성에 대한 구성 설정을 지원하는지 여부를 나타내는 값을 가져옵니다.

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 만듭니다.

Send(HttpRequestMessage, CancellationToken)

파생 클래스에서 재정의된 경우 지정된 요청 및 취소 토큰을 사용하여 HTTP 요청을 보냅니다. 그렇지 않으면 NotSupportedException이 throw됩니다.

(다음에서 상속됨 HttpMessageHandler)
SendAsync(HttpRequestMessage, CancellationToken)

에 제공된 HttpRequestMessage 정보를 기반으로 의 HttpResponseMessage instance 차단하지 않는 작업으로 만듭니다.

ToString()

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

(다음에서 상속됨 Object)

적용 대상

추가 정보