HttpListenerResponse クラス
メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。 HttpListener オブジェクトによって処理される要求に対する応答を表します。
名前空間: System.Net
アセンブリ: System (system.dll 内)
構文
解説
使用例
継承階層
スレッド セーフ
プラットフォーム
バージョン情報
参照
アセンブリ: System (system.dll 内)
構文Public NotInheritable Class HttpListenerResponse Implements IDisposable
public sealed class HttpListenerResponse : IDisposable
public final class HttpListenerResponse implements IDisposable
public final class HttpListenerResponse implements IDisposable
解説クライアントが HttpListener オブジェクトによって処理されるリソースの要求を行うと、その要求と応答がアプリケーションの HttpListenerContext オブジェクトで使用できるようになります。要求は HttpListenerRequest オブジェクトで表され、HttpListenerContext.Request プロパティで使用できます。応答は HttpListenerResponse オブジェクトで表され、HttpListenerContext.Response プロパティで使用できます。
StatusCode、StatusDescription、Cookies など、さまざまなプロパティを設定することによって、応答をカスタマイズできます。HttpListenerResponse.OutputStream プロパティを使用して、応答データの書き込み先として使用できる Stream インスタンスを取得します。最後に、Close メソッドを呼び出して、クライアントに応答データを送信します。
使用例// 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
System.Net.HttpListenerResponse
スレッド セーフプラットフォームWindows 98, Windows Server 2003, Windows XP Media Center Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照HttpListenerResponse プロパティ
パブリック プロパティ| 名前 | 説明 | |
|---|---|---|
.gif) | ContentEncoding | この応答の OutputStream の Encoding を取得または設定します。 |
| | ContentLength64 | 応答に含まれている本体データのバイト数を取得または設定します。 |
| | ContentType | 返されるコンテンツの MIME タイプを取得または設定します。 |
| | Cookies | 応答と共に返される Cookie のコレクションを取得または設定します。 |
| | Headers | サーバーから返されるヘッダーの名前と値のペアのコレクションを取得または設定します。 |
| | KeepAlive | サーバーが永続的な接続を要求しているかどうかを示す値を取得または設定します。 |
| | OutputStream | 応答の書き込み先として使用できる Stream オブジェクトを取得します。 |
| | ProtocolVersion | 応答に使用する HTTP バージョンを取得または設定します。 |
| | RedirectLocation | この応答の Location HTTP ヘッダーの値を取得または設定します。 |
| | SendChunked | 応答がチャンク処理された転送エンコーディングを使用するかどうかを取得または設定します。 |
| | StatusCode | クライアントへ返される HTTP ステータス コードを取得または設定します。 |
| | StatusDescription | クライアントへ返される HTTP ステータス コードの説明テキストを取得または設定します。 |
参照HttpListenerResponse メソッド
パブリック メソッド
(
プロテクト メソッド
も参照)
| 名前 | 説明 | |
|---|---|---|
.gif) | Abort | 応答を送信せずにクライアントとの間の接続を閉じます。 |
| | AddHeader | 指定したヘッダーと値をこの応答の HTTP ヘッダーに追加します。 |
| | AppendCookie | 指定した Cookie をこの応答の Cookie のコレクションに追加します。 |
| | AppendHeader | この応答と共に送信される、指定した HTTP ヘッダーに値を追加します。 |
| | Close | オーバーロードされます。 クライアントに応答を送信し、この HttpListenerResponse インスタンスに保持されているリソースを解放します。 |
| | CopyFrom | プロパティを、指定した HttpListenerResponse からこの応答へコピーします。 |
| | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。) |
| | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。) |
| | GetType | 現在のインスタンスの Type を取得します。 ( Object から継承されます。) |
| | Redirect | 指定した URL にクライアントをリダイレクトするように応答を構成します。 |
.gif) | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。) |
| | SetCookie | この応答と共に送信された Cookie のコレクションに対して Cookie を追加または更新します。 |
| | ToString | 現在の Object を表す String を返します。 ( Object から継承されます。) |
プロテクト メソッド| 名前 | 説明 | |
|---|---|---|
.gif) | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。) |
| | MemberwiseClone | 現在の Object の簡易コピーを作成します。 ( Object から継承されます。) |
明示的インターフェイスの実装参照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 から継承されます。) |
明示的インターフェイスの実装参照- HttpListenerResponseのページへのリンク
