HttpListenerResponse

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

HttpListenerResponse クラス

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

HttpListener オブジェクトによって処理される要求に対する応答を表します。

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

Visual Basic (宣言)

Public NotInheritable Class
 HttpListenerResponse
    Implements IDisposable

Visual Basic (使用法)

Dim instance As HttpListenerResponse

C#

public sealed class HttpListenerResponse :
 IDisposable

C++

public ref class HttpListenerResponse sealed
 : IDisposable

J#

public final class HttpListenerResponse implements
 IDisposable

JScript

public final class HttpListenerResponse implements
 IDisposable

解説

クライアントが HttpListener オブジェクトによって処理されるリソースの要求を行うと、その要求と応答がアプリケーションの HttpListenerContext オブジェクトで使用できるようになります。要求は HttpListenerRequest オブジェクトで表され、HttpListenerContext.Request プロパティで使用できます。応答は HttpListenerResponse オブジェクトで表され、HttpListenerContext.Response プロパティで使用できます。

StatusCode、StatusDescription、Cookies など、さまざまなプロパティを設定することによって、応答をカスタマイズできます。HttpListenerResponse.OutputStream プロパティを使用して、応答データの書き込み先として使用できる Stream インスタンスを取得します。最後に、Close メソッドを呼び出して、クライアントに応答データを送信します。

使用例

クライアント要求に応答するコード例を次に示します。

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.HttpListenerResponse

スレッド セーフ

この型の 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

参照

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

HttpListenerResponse プロパティ

パブリック プロパティ

	名前	説明
	ContentEncoding	この応答の OutputStream の Encoding を取得または設定します。
	ContentLength64	応答に含まれている本体データのバイト数を取得または設定します。
	ContentType	返されるコンテンツの MIME タイプを取得または設定します。
	Cookies	応答と共に返される Cookie のコレクションを取得または設定します。
	Headers	サーバーから返されるヘッダーの名前と値のペアのコレクションを取得または設定します。
	KeepAlive	サーバーが永続的な接続を要求しているかどうかを示す値を取得または設定します。
	OutputStream	応答の書き込み先として使用できる Stream オブジェクトを取得します。
	ProtocolVersion	応答に使用する HTTP バージョンを取得または設定します。
	RedirectLocation	この応答の Location HTTP ヘッダーの値を取得または設定します。
	SendChunked	応答がチャンク処理された転送エンコーディングを使用するかどうかを取得または設定します。
	StatusCode	クライアントへ返される HTTP ステータス コードを取得または設定します。
	StatusDescription	クライアントへ返される HTTP ステータス コードの説明テキストを取得または設定します。

参照

関連項目

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

HttpListenerResponse メソッド

パブリック メソッド

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

	名前	説明
	Abort	応答を送信せずにクライアントとの間の接続を閉じます。
	AddHeader	指定したヘッダーと値をこの応答の HTTP ヘッダーに追加します。
	AppendCookie	指定した Cookie をこの応答の Cookie のコレクションに追加します。
	AppendHeader	この応答と共に送信される、指定した HTTP ヘッダーに値を追加します。
	Close	オーバーロードされます。 クライアントに応答を送信し、この HttpListenerResponse インスタンスに保持されているリソースを解放します。
	CopyFrom	プロパティを、指定した HttpListenerResponse からこの応答へコピーします。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	Redirect	指定した URL にクライアントをリダイレクトするように応答を構成します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	SetCookie	この応答と共に送信された Cookie のコレクションに対して Cookie を追加または更新します。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

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

明示的インターフェイスの実装

	名前	説明
	System.IDisposable.Dispose	HttpListenerResponse によって使用されているすべてのリソースを解放します。

参照

関連項目

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

HttpListenerResponse メンバ

HttpListener オブジェクトによって処理される要求に対する応答を表します。

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

パブリック プロパティ

	名前	説明
	ContentEncoding	この応答の OutputStream の Encoding を取得または設定します。
	ContentLength64	応答に含まれている本体データのバイト数を取得または設定します。
	ContentType	返されるコンテンツの MIME タイプを取得または設定します。
	Cookies	応答と共に返される Cookie のコレクションを取得または設定します。
	Headers	サーバーから返されるヘッダーの名前と値のペアのコレクションを取得または設定します。
	KeepAlive	サーバーが永続的な接続を要求しているかどうかを示す値を取得または設定します。
	OutputStream	応答の書き込み先として使用できる Stream オブジェクトを取得します。
	ProtocolVersion	応答に使用する HTTP バージョンを取得または設定します。
	RedirectLocation	この応答の Location HTTP ヘッダーの値を取得または設定します。
	SendChunked	応答がチャンク処理された転送エンコーディングを使用するかどうかを取得または設定します。
	StatusCode	クライアントへ返される HTTP ステータス コードを取得または設定します。
	StatusDescription	クライアントへ返される HTTP ステータス コードの説明テキストを取得または設定します。

パブリック メソッド

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

	名前	説明
	Abort	応答を送信せずにクライアントとの間の接続を閉じます。
	AddHeader	指定したヘッダーと値をこの応答の HTTP ヘッダーに追加します。
	AppendCookie	指定した Cookie をこの応答の Cookie のコレクションに追加します。
	AppendHeader	この応答と共に送信される、指定した HTTP ヘッダーに値を追加します。
	Close	オーバーロードされます。 クライアントに応答を送信し、この HttpListenerResponse インスタンスに保持されているリソースを解放します。
	CopyFrom	プロパティを、指定した HttpListenerResponse からこの応答へコピーします。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	Redirect	指定した URL にクライアントをリダイレクトするように応答を構成します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	SetCookie	この応答と共に送信された Cookie のコレクションに対して Cookie を追加または更新します。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

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

明示的インターフェイスの実装

	名前	説明
	System.IDisposable.Dispose	HttpListenerResponse によって使用されているすべてのリソースを解放します。

参照

関連項目

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