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 インスタンスを作成します。 アプリは、必要に応じて HttpRequestMessage のさまざまなプロパティを設定します。 その後、HttpRequestMessage が HttpClient.SendRequestAsync メソッドのいずれかにパラメーターとして渡されます。

HttpClient クラスの便利なメソッドの数は、アプリの HttpRequestMessage オブジェクトを自動的に作成します。 次のような方法があります。

• DeleteAsync。
• GetAsync メソッド。
• GetBufferAsync。
• GetInputStreamAsync。
• GetStringAsync。
• PostAsync。
• PutAsync。

フィルター パイプラインに追加するすべてのフィルターは、アプリによって明示的に指定されたか、自動的に構築されたかにかかわらず、HttpRequestMessage オブジェクトを渡します。

コンストラクター

HttpRequestMessage()	HttpRequestMessage クラスの新しいインスタンスを初期化します。
HttpRequestMessage(HttpMethod, Uri)	HTTP メソッドと要求 URI を使用して 、HttpRequestMessage クラスの新しいインスタンスを初期化 します。

プロパティ

Content	HttpRequestMessage オブジェクト上のサーバーに送信する HTTP コンテンツを取得または設定します。
Headers	HttpRequestMessage に関連付けられている HTTP 要求ヘッダーのコレクションを取得します。
Method	要求 URI に対して実行される HTTP メソッドを取得または設定します。
PrivacyAnnotation	ヘッダーを含む HTTP 要求メッセージを表します。
Properties	開発者が使用する HttpRequestMessage インスタンスのプロパティのセットを取得します。
RequestUri	HttpRequestMessage オブジェクトに使用される Uri を取得または設定します。
TransportInformation	HTTP 接続で使用される基になるトランスポート ソケットに関する情報を取得します。

メソッド

Close()	HttpRequestMessage インスタンスを閉じ、割り当てられたリソースを解放します。
Dispose()	アンマネージ リソースの解放またはリセットに関連付けられているアプリケーション定義のタスクを実行します。
ToString()	現在の HttpRequestMessage オブジェクトを表す文字列を返します。

こちらもご覧ください

• HttpClient
• IClosable
• IStringable