HttpRequestMessage 클래스

정의

네임스페이스:

Windows.Web.Http

헤더를 포함한 HTTP 요청 메시지를 나타냅니다.

public ref class HttpRequestMessage sealed : IClosable, IStringable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Web.Http.IHttpRequestMessageFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class HttpRequestMessage final : IClosable, IStringable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Web.Http.IHttpRequestMessageFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class HttpRequestMessage : System.IDisposable, IStringable

function HttpRequestMessage(method, uri)

Public NotInheritable Class HttpRequestMessage
Implements IDisposable, IStringable

상속

Object Platform::Object IInspectable HttpRequestMessage

특성

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

구현

IClosable IDisposable IStringable

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

설명

HttpRequestMessage 클래스에는 헤더, HTTP 동사 및 잠재적으로 데이터가 포함됩니다. 이 클래스는 일반적으로 HTTP 요청에 대한 추가 제어가 필요한 개발자가 사용합니다. 일반적인 예는 다음과 같습니다.

• 기본 SSL/TLS 전송 정보를 검사합니다.
• 덜 일반적인 HTTP 메서드를 사용하려면
• HttpRequestMessage에서 요청 속성을 명시적으로 설정하려면

이러한 경우 앱은 HttpRequestMessage 생성자 중 하나를 사용하여 HttpRequestMessage instance 만듭니다. 앱은 필요에 따라 HttpRequestMessage에서 다양한 속성을 설정합니다. 그런 다음 HttpRequestMessage가 HttpClient.SendRequestAsync 메서드 중 하나에 매개 변수로 전달됩니다.

HttpClient 클래스의 여러 편의 메서드는 앱에 대한 HttpRequestMessage 개체를 자동으로 만듭니다. 이러한 메서드에는 다음이 포함됩니다.

• DeleteAsync.
• GetAsync 메서드입니다.
• GetBufferAsync.
• GetInputStreamAsync.
• GetStringAsync.
• PostAsync.
• PutAsync.

필터 파이프라인에 추가하는 모든 필터는 앱에서 명시적으로 지정했거나 자동으로 생성되었는지 여부에 관계없이 HttpRequestMessage 개체를 전달합니다.

생성자

HttpRequestMessage()	HttpRequestMessage 클래스의 새 instance 초기화합니다.
HttpRequestMessage(HttpMethod, Uri)	HTTP 메서드 및 요청 Uri를 사용하여 HttpRequestMessage 클래스의 새 instance 초기화합니다.

속성

Content	HttpRequestMessage 개체의 서버로 보낼 HTTP 콘텐츠를 가져오거나 설정합니다.
Headers	HttpRequestMessage와 연결된 HTTP 요청 헤더의 컬렉션을 가져옵니다.
Method	요청 URI에서 수행할 HTTP 메서드를 가져오거나 설정합니다.
PrivacyAnnotation	헤더를 포함한 HTTP 요청 메시지를 나타냅니다.
Properties	개발자가 사용할 HttpRequestMessage instance 속성 집합을 가져옵니다.
RequestUri	HttpRequestMessage 개체에 사용되는 Uri를 가져오거나 설정합니다.
TransportInformation	HTTP 연결에서 사용하는 기본 전송 소켓에 대한 정보를 가져옵니다.

메서드

Close()	HttpRequestMessage instance 닫고 할당된 리소스를 해제합니다.
Dispose()	관리되지 않는 리소스의 확보, 해제 또는 다시 설정과 관련된 애플리케이션 정의 작업을 수행합니다.
ToString()	현재 HttpRequestMessage 개체를 나타내는 문자열을 반환합니다.

추가 정보

• HttpClient
• IClosable
• IStringable