HttpListenerRequest

.NET Framework クラス ライブラリ リファレンス

HttpListenerRequest クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

HttpListener オブジェクトに対する受信 HTTP 要求を記述します。このクラスは継承できません。

名前空間: System.Net
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 HttpListenerRequest

Visual Basic (使用法)

Dim instance As HttpListenerRequest

C#

public sealed class HttpListenerRequest

C++

public ref class HttpListenerRequest sealed

J#

public final class HttpListenerRequest

JScript

public final class HttpListenerRequest

解説

クライアントが HttpListener オブジェクトで処理される URI (Uniform Resource Identifier) に対して要求を実行すると、HttpListener が送信元、要求、およびクライアントに送信される応答に関する情報を格納する HttpListenerContext オブジェクトを提供します。HttpListenerContext.Request プロパティは、要求を記述する HttpListenerRequest オブジェクトを返します。

HttpListenerRequest オブジェクトには、要求 HttpMethod 文字列、UserAgent 文字列、要求の本体データなど、要求に関する情報が格納されます (詳細については InputStream を参照)。

要求に応答するには、Response プロパティを使用して、関連付けられている応答を取得する必要があります。

使用例

HttpListenerRequest を受信し、応答を返す方法を次のコード例に示します。

C#

// This example requires the System and System.Net namespaces.
public static void SimpleListenerExample(string[]
 prefixes)
{
    if (!HttpListener.IsSupported)
    {
        Console.WriteLine ("Windows XP SP2 or Server 2003 is required to use
 the HttpListener class.");
        return;
    }
    // URI prefixes are required,
    // for example "http://contoso.com:8080/index/".
    if (prefixes == null || prefixes.Length
 == 0)
      throw new ArgumentException("prefixes");
    
    // Create a listener.
    HttpListener listener = new HttpListener();
    // Add the prefixes.
    foreach (string s in
 prefixes)
    {
        listener.Prefixes.Add(s);
    }
    listener.Start();
    Console.WriteLine("Listening...");
    // Note: The GetContext method blocks while waiting for a request.
 
    HttpListenerContext context = listener.GetContext();
    HttpListenerRequest request = context.Request;
    // Obtain a response object.
    HttpListenerResponse response = context.Response;
    // Construct a response.
    string responseString = "<HTML><BODY> Hello
 world!</BODY></HTML>";
    byte[] buffer = System.Text.Encoding.UTF8.GetBytes(responseString);
    // Get a response stream and write the response to it.
    response.ContentLength64 = buffer.Length;
    System.IO.Stream output = response.OutputStream;
    output.Write(buffer,0,buffer.Length);
    // You must close the output stream.
    output.Close();
    listener.Stop();
}

継承階層

System.Object
  System.Net.HttpListenerRequest

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows Server 2003, Windows XP Media Center Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
HttpListenerRequest メンバ
System.Net 名前空間
HttpListener クラス
HttpListenerContext クラス
HttpListenerResponse

HttpListenerRequest プロパティ

パブリック プロパティ

	名前	説明
	AcceptTypes	クライアントが受け入れる MIME タイプを取得します。
	ClientCertificateError	クライアントから提供された X509Certificate の問題を識別するエラー コードを取得します。
	ContentEncoding	要求と共に送信されるデータに使用できるコンテンツ エンコーディングを取得します。
	ContentLength64	要求に含まれている本体データの長さを取得します。
	ContentType	要求に含まれている本体データの MIME タイプを取得します。
	Cookies	要求と共に送信された Cookie を取得します。
	HasEntityBody	要求に関連付けられている本体データがあるかどうかを示す Boolean 値を取得します。
	Headers	要求で送信されるヘッダーの名前と値のペアのコレクションを取得します。
	HttpMethod	クライアントによって指定された HTTP メソッドを取得します。
	InputStream	クライアントから送信された本体データを格納しているストリームを取得します。
	IsAuthenticated	この要求の送信元クライアントが認証されているかどうかを示す Boolean 値を取得します。
	IsLocal	要求がローカル コンピュータから送信されたかどうかを示す Boolean 値を取得します。
	IsSecureConnection	要求の送信に使用された TCP 接続が SSL (Secure Sockets Layer) プロトコルを使用しているかどうかを示す Boolean 値を取得します。
	KeepAlive	クライアントが永続的な接続を要求しているかどうかを示す Boolean 値を取得します。
	LocalEndPoint	要求の転送先のサーバー IP アドレスおよびポート番号を取得します。
	ProtocolVersion	要求元クライアントで使用されている HTTP のバージョンを取得します。
	QueryString	要求に含まれているクエリ文字列を取得します。
	RawUrl	クライアントによって要求された (ホストおよびポートを含まない) URL 情報を取得します。
	RemoteEndPoint	要求の発行元の IP アドレスおよびポート番号を取得します。
	RequestTraceIdentifier	受信 HTTP 要求の要求 ID を取得します。
	Url	クライアントによって要求された Uri オブジェクトを取得します。
	UrlReferrer	クライアントをサーバーに導いたリソースの URI (Uniform Resource Identifier) を取得します。
	UserAgent	クライアントによって示されたユーザー エージェントを取得します。
	UserHostAddress	要求の転送先のサーバー IP アドレスおよびポート番号を取得します。
	UserHostName	DNS 名およびクライアントによって指定されたポート番号 (存在する場合) を取得します。
	UserLanguages	応答への使用に適している自然言語を取得します。

参照

関連項目

HttpListenerRequest クラス
System.Net 名前空間
HttpListener クラス
HttpListenerContext クラス
HttpListenerResponse

HttpListenerRequest メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	BeginGetClientCertificate	クライアントの X.509 v.3 証明書への非同期要求を開始します。
	EndGetClientCertificate	クライアントの X.509 v.3 証明書への非同期要求を終了します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetClientCertificate	クライアントの X.509 v.3 証明書を取得します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

HttpListenerRequest クラス
System.Net 名前空間
HttpListener クラス
HttpListenerContext クラス
HttpListenerResponse

HttpListenerRequest メンバ

HttpListener オブジェクトに対する受信 HTTP 要求を記述します。このクラスは継承できません。

HttpListenerRequest データ型で公開されるメンバを以下の表に示します。

パブリック プロパティ

	名前	説明
	AcceptTypes	クライアントが受け入れる MIME タイプを取得します。
	ClientCertificateError	クライアントから提供された X509Certificate の問題を識別するエラー コードを取得します。
	ContentEncoding	要求と共に送信されるデータに使用できるコンテンツ エンコーディングを取得します。
	ContentLength64	要求に含まれている本体データの長さを取得します。
	ContentType	要求に含まれている本体データの MIME タイプを取得します。
	Cookies	要求と共に送信された Cookie を取得します。
	HasEntityBody	要求に関連付けられている本体データがあるかどうかを示す Boolean 値を取得します。
	Headers	要求で送信されるヘッダーの名前と値のペアのコレクションを取得します。
	HttpMethod	クライアントによって指定された HTTP メソッドを取得します。
	InputStream	クライアントから送信された本体データを格納しているストリームを取得します。
	IsAuthenticated	この要求の送信元クライアントが認証されているかどうかを示す Boolean 値を取得します。
	IsLocal	要求がローカル コンピュータから送信されたかどうかを示す Boolean 値を取得します。
	IsSecureConnection	要求の送信に使用された TCP 接続が SSL (Secure Sockets Layer) プロトコルを使用しているかどうかを示す Boolean 値を取得します。
	KeepAlive	クライアントが永続的な接続を要求しているかどうかを示す Boolean 値を取得します。
	LocalEndPoint	要求の転送先のサーバー IP アドレスおよびポート番号を取得します。
	ProtocolVersion	要求元クライアントで使用されている HTTP のバージョンを取得します。
	QueryString	要求に含まれているクエリ文字列を取得します。
	RawUrl	クライアントによって要求された (ホストおよびポートを含まない) URL 情報を取得します。
	RemoteEndPoint	要求の発行元の IP アドレスおよびポート番号を取得します。
	RequestTraceIdentifier	受信 HTTP 要求の要求 ID を取得します。
	Url	クライアントによって要求された Uri オブジェクトを取得します。
	UrlReferrer	クライアントをサーバーに導いたリソースの URI (Uniform Resource Identifier) を取得します。
	UserAgent	クライアントによって示されたユーザー エージェントを取得します。
	UserHostAddress	要求の転送先のサーバー IP アドレスおよびポート番号を取得します。
	UserHostName	DNS 名およびクライアントによって指定されたポート番号 (存在する場合) を取得します。
	UserLanguages	応答への使用に適している自然言語を取得します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	BeginGetClientCertificate	クライアントの X.509 v.3 証明書への非同期要求を開始します。
	EndGetClientCertificate	クライアントの X.509 v.3 証明書への非同期要求を終了します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetClientCertificate	クライアントの X.509 v.3 証明書を取得します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

HttpListenerRequest クラス
System.Net 名前空間
HttpListener クラス
HttpListenerContext クラス
HttpListenerResponse