次の方法で共有


HttpRequestMessage クラス

定義

ヘッダーを含む HTTP 要求メッセージを表します。

public ref class HttpRequestMessage sealed : IClosable, IStringable
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Web.Http.IHttpRequestMessageFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class HttpRequestMessage final : 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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Web.Http.IHttpRequestMessageFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class HttpRequestMessage : System.IDisposable, 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
属性
実装

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 オブジェクトを自動的に作成します。 次のような方法があります。

フィルター パイプラインに追加するすべてのフィルターは、アプリによって明示的に指定されたか、自動的に構築されたかにかかわらず、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 オブジェクトを表す文字列を返します。

適用対象

こちらもご覧ください