System.Net.Http Namespace

System.Net.Http 네임스페이스는 최신 HTTP 응용 프로그램의 프로그래밍 인터페이스를 제공합니다. The System.Net.Http namespace provides a programming interface for modern HTTP applications.

클래스

ByteArrayContent

바이트 배열에 따라 HTTP 콘텐츠를 제공합니다.Provides HTTP content based on a byte array.

CFNetworkHandler
DelegatingHandler

HTTP 응답 메시지의 처리를 내부 처리기라는 다른 처리기로 위임하는 HTTP 처리기의 형식입니다.A type for HTTP handlers that delegate the processing of HTTP response messages to another handler, called the inner handler.

FormUrlEncodedContent

application/x-www-form-urlencoded MIME 형식을 사용하여 인코딩된 이름/값 튜플의 컨테이너입니다.A container for name/value tuples encoded using application/x-www-form-urlencoded MIME type.

HttpClient

URI로 식별되는 리소스에서 HTTP 요청을 보내고 HTTP 응답을 받기 위한 기본 클래스를 제공합니다.Provides a base class for sending HTTP requests and receiving HTTP responses from a resource identified by a URI.

HttpClientHandler

.NET Framework 및.NET Core 2.0 이전 버전의 HttpClient에서 사용되는 기본 메시지 처리기입니다.The default message handler used by HttpClient in .NET Framework and .NET Core 2.0 and earlier.

HttpContent

HTTP 엔터티 본문과 콘텐츠 헤더를 나타내는 기본 클래스입니다.A base class representing an HTTP entity body and content headers.

HttpMessageHandler

HTTP 메시지 처리기의 기본 형식입니다.A base type for HTTP message handlers.

HttpMessageInvoker

애플리케이션이 HTTP 처리기 체인에서 SendAsync(HttpRequestMessage, CancellationToken) 메서드를 호출할 수 있는 특수 클래스입니다.A specialty class that allows applications to call the SendAsync(HttpRequestMessage, CancellationToken) method on an HTTP handler chain.

HttpMethod

표준 HTTP 메서드를 검색 및 비교하고 새 HTTP 메서드를 만들기 위한 도우미 클래스입니다.A helper class for retrieving and comparing standard HTTP methods and for creating new HTTP methods.

HttpRequestException

HttpClientHttpMessageHandler 클래스가 throw하는 예외의 기본 클래스입니다.A base class for exceptions thrown by the HttpClient and HttpMessageHandler classes.

HttpRequestMessage

HTTP 요청 메시지를 나타냅니다.Represents a HTTP request message.

HttpResponseMessage

상태 코드 및 데이터를 포함 하 여 HTTP 응답 메시지를 나타냅니다.Represents a HTTP response message including the status code and data.

MessageProcessingHandler

요청 및/또는 응답 메시지의 적은 처리만 수행하는 처리기의 기본 형식입니다.A base type for handlers which only do some small processing of request and/or response messages.

MultipartContent

multipart/* 콘텐츠 형식 지정을 사용하여 serialize된 HttpContent 개체의 컬렉션을 제공합니다.Provides a collection of HttpContent objects that get serialized using the multipart/* content type specification.

MultipartFormDataContent

multipart/form-data MIME 형식을 사용하여 인코딩된 콘텐츠에 대한 컨테이너를 제공합니다.Provides a container for content encoded using multipart/form-data MIME type.

NSUrlSessionHandler
ReadOnlyMemoryContent
RtcRequestFactory
SocketsHttpHandler

.NET Core 2.1 이상 버전의 HttpClient에서 사용되는 기본 메시지 처리기를 제공합니다.Provides the default message handler used by HttpClient in .NET Core 2.1 and later.

StreamContent

스트림에 따라 HTTP 콘텐츠를 제공합니다.Provides HTTP content based on a stream.

StringContent

문자열에 따라 HTTP 콘텐츠를 제공합니다.Provides HTTP content based on a string.

WebRequestHandler

Windows 스토어 응용 프로그램 또는 다른 환경에서 사용할 수 없는 데스크톱 고유의 기능을 제공합니다.Provides desktop-specific features not available to Windows Store apps or other environments.

WinHttpHandler

WinHttpHandler는 Windows의 WinHTTP 인터페이스를 기반으로 하는 특수 메시지 처리기이며 서버 환경에서 사용하기 위한 것입니다.WinHttpHandler is a specialty message handler based on the WinHTTP interface of Windows and is intended for use in server environments. 이 클래스는 NuGet 패키지로 설치하여 데스크톱 앱에도 사용할 수 있습니다.This class is also available for use in Desktop apps by installing it as a NuGet package. 데스크톱 앱에서 사용할 수 있도록 이 클래스를 설치하는 방법에 대한 자세한 내용은 System.Net.Http.WinHttpHandler를 참조하세요.For more information about installing this class for use in Desktop apps, see System.Net.Http.WinHttpHandler.

열거형

ClientCertificateOption

클라이언트 인증서 제공 방식을 지정합니다.Specifies how client certificates are provided.

CookieUsePolicy

이 열거형을 사용하면 서버와 통신할 때 HTTP 쿠키를 제어할 수 있습니다.This enumeration allows control of HTTP cookies when communicating with the server.

HttpCompletionOption

HttpClient 작업이 응답이 가능하면 즉시 완료된 것으로 간주되어야 하는지, 아니면 콘텐츠가 담긴 전체 응답 메시지를 읽은 후 완료된 것으로 간주되어야 하는지 여부를 나타냅니다.Indicates if HttpClient operations should be considered completed either as soon as a response is available, or after reading the entire response message including the content.

WindowsProxyUsePolicy

이 열거형은 Windows에서 실행될 때 HttpClient에 사용된 프록시 설정에 대해 사용 가능한 옵션을 제공합니다.This enumeration provides available options for the proxy settings used by an HttpClient when running on Windows.

설명

System.Net.Http 네임 스페이스는 다음을 제공 하도록 설계 되었습니다.The System.Net.Http namespace is designed to provide the following:

  1. HTTP 클라이언트 구성 요소 사용자가 HTTP를 통해 최신 웹 서비스를 사용할 수 있도록 합니다.HTTP client components that allow users to consume modern web services over HTTP.

  2. 사용할 수 있는 HTTP 구성 요소에서 클라이언트와 서버 (HTTP 헤더 및 예를 들어 메시지).HTTP components that can be used by both clients and servers (HTTP headers and messages, for example). 이 일관 된 프로그래밍 모델을 제공 클라이언트 및 서버 쪽 모두에 최신 웹 서비스에 대 한 HTTP를 통해.This provides a consistent programming model on both the client and the server side for modern web services over HTTP.

합니다 System.Net.Http 네임 스페이스 및 관련 된 System.Net.Http.Headers 네임 스페이스는 다음 구성 요소 집합을 제공 합니다.The System.Net.Http namespace and the related System.Net.Http.Headers namespace provide the following set of components:

  1. HttpClient -보내고 HTTP를 통해 요청을 수신 하는 데 사용 하는 기본 클래스입니다.HttpClient - the primary class used to send and receive requests over HTTP.

  2. HttpRequestMessageHttpResponseMessage -IETF RFC 2616에 정의 된 대로 HTTP 메시지입니다.HttpRequestMessage and HttpResponseMessage - HTTP messages as defined in RFC 2616 by the IETF.

  3. HttpHeaders IETF RFC 2616에 정의 된 대로 HTTP 헤더입니다.HttpHeaders - HTTP headers as defined in RFC 2616 by the IETF.

  4. HttpClientHandler HTTP 응답 메시지를 생성 하는 일을 담당 하는 HTTP 처리기입니다.HttpClientHandler - HTTP handlers responsible for producing HTTP response messages.

사용할 수 있는 다양 한 HTTP 메시지 처리 있습니다.There are various HTTP message handles that can be used. 여기에 다음이 포함 됩니다.These include the following.

  1. DelegatingHandler -클래스에는 처리기 체인에 처리기를 연결 하는 데 사용 합니다.DelegatingHandler - A class used to plug a handler into a handler chain.

  2. HttpMessageHandler 대부분의 응용 프로그램에 대 한 가장 일반적인 요구 사항을 지 원하는 클래스를 파생할-단순 합니다.HttpMessageHandler - A simple to class to derive from that supports the most common requirements for most applications.

  3. HttpClientHandler -실제로 HTTP 전송 작업을 처리 하는 처리기 체인의 맨 아래에서 작동 하는 클래스입니다.HttpClientHandler - A class that operates at the bottom of the handler chain that actually handles the HTTP transport operations.

  4. WebRequestHandler 관련 된 옵션을 사용 하 여 HTTP 전송 작업을 처리 하는 처리기 체인 클래스의 맨 아래에서 작동 하는-특수 클래스는 System.Net.HttpWebRequest 개체입니다.WebRequestHandler - A specialty class that operates at the bottom of the handler chain class that handles HTTP transport operations with options that are specific to the System.Net.HttpWebRequest object.

RFC 2616에 정의 된 엔터티 본문에 해당 하는 HTTP 메시지의 내용입니다.The contents of an HTTP message corresponds to the entity body defined in RFC 2616.

HTTP 콘텐츠를 다양 한 클래스를 사용할 수 있습니다.A number of classes can be used for HTTP content. 여기에 다음이 포함 됩니다.These include the following.

  1. ByteArrayContent HTTP 콘텐츠를 바이트 배열을 기반으로 합니다.ByteArrayContent - HTTP content based on a byte array.

  2. FormUrlEncodedContent HTTP 콘텐츠의 이름/값 튜플의 응용 프로그램/x-www-형식-urlencoded MIME 형식을 사용 하 여 인코딩됩니다.FormUrlEncodedContent - HTTP content of name/value tuples encoded using application/x-www-form-urlencoded MIME type.

  3. MultipartContent Multipart를 사용 하 여 serialize 되는 HTTP 콘텐츠 / * 콘텐츠 형식 사양을 합니다.MultipartContent - HTTP content that gets serialized using the multipart/* content type specification.

  4. MultipartFormDataContent HTTP 콘텐츠 multipart/form-data MIME 형식을 사용 하 여 인코딩됩니다.MultipartFormDataContent - HTTP content encoded using the multipart/form-data MIME type.

  5. StreamContent HTTP 콘텐츠 스트림을 기반으로 합니다.StreamContent - HTTP content based on a stream.

  6. StringContent HTTP 콘텐츠 문자열을 기반으로 합니다.StringContent - HTTP content based on a string.

앱을 사용 하는 경우는 System.Net.HttpSystem.Net.Http.Headers 네임 스페이스에서 많은 양의 데이터 (50 메가바이트 또는 그 이상)를 다운로드 하 고 앱 해야 이러한 다운로드를 스트림 하는 기본 버퍼링을 사용 하지.If an app using the System.Net.Http and System.Net.Http.Headers namespaces intends to download large amounts of data (50 megabytes or more), then the app should stream those downloads and not use the default buffering. 기본 버퍼링을 사용 하는 경우 클라이언트 메모리 사용량이 매우 큰, 성능 저하 잠재적으로 인해 크게 됩니다.If the default buffering is used the client memory usage will get very large, potentially resulting in substantially reduced performance.

클래스는 System.Net.HttpSystem.Net.Http.Headers 네임 스페이스는 Windows 스토어 앱 또는 데스크톱 앱 개발에 사용할 수 있습니다.Classes in the System.Net.Http and System.Net.Http.Headers namespaces can be used to develop Windows Store apps or desktop apps. Windows 스토어 앱에서 사용 하는 경우의 클래스는 System.Net.HttpSystem.Net.Http.Headers 네임 스페이스는 네트워크 격리 기능에 사용 되는 애플리케이션 보안 모델의 영향을 받지는 Windows 8Windows 8합니다.When used in a Windows Store app, classes in the System.Net.Http and System.Net.Http.Headers namespaces are affected by network isolation feature, part of the application security model used by the Windows 8Windows 8. 적절 한 네트워크 기능을 Windows 스토어 앱에서 네트워크 액세스를 허용 하도록 시스템에 대 한 Windows 스토어 앱 용 응용 프로그램 매니페스트에서 활성화 되어야 합니다.The appropriate network capabilities must be enabled in the app manifest for a Windows Store app for the system to allow network access by a Windows store app. 자세한 내용은 Windows 스토어 앱에 대한 네트워크 격리를 참조하세요.For more information, see the Network Isolation for Windows Store Apps.