HttpListenerContext クラスとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

HttpListenerContext クラス

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

HttpListener クラスで使用される要求オブジェクトと応答オブジェクトへのアクセスを提供します。このクラスは継承できません。

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

Visual Basic (宣言)

Public NotInheritable Class
 HttpListenerContext

Visual Basic (使用法)

Dim instance As HttpListenerContext

public sealed class HttpListenerContext

C++

public ref class HttpListenerContext sealed

public final class HttpListenerContext

JScript

public final class HttpListenerContext

解説

このクラスは、HttpListener オブジェクトで処理されるクライアントのハイパーテキスト転送プロトコル (HTTP: Hypertext Transfer Protocol) 要求に関連する情報を提供します。GetContext メソッドは、HttpListenerContext クラスのインスタンスを返します。クライアント要求を表すオブジェクトを取得するには、Request プロパティを使用します。HttpListener によってクライアントに送信される応答を表すオブジェクトを取得するには、Response プロパティを使用します。要求の送信元のクライアントに関する情報 (ログイン名、クライアントが認証されているかどうかなど) を取得するには、User プロパティから返される IPrincipal オブジェクトのプロパティを照会できます。

HttpListenerContext オブジェクトを閉じると、クライアントに応答が送信され、HttpListenerContext が使用していたリソースが解放されます。HttpListenerContext オブジェクトを中断すると、まだ送信されていない場合はクライアントへの応答が破棄され、HttpListenerContext が使用していたリソースが解放されます。HttpListenerContext オブジェクトを閉じるか中断した後で、このオブジェクトのメソッドまたはプロパティを参照することはできません。これを行うと、ObjectDisposedException 例外が発生します。

Windows XP Home Edition, Windows XP Professional x64 Edition, Windows Server 2003 プラットフォームメモ : HttpListener クラスを使用するには、Service Pack 2 が必要です。

使用例

クライアント要求のユーザー情報を表示するコード例を次に示します。

public static bool RemoveAllPrefixes(HttpListener
 listener)
{
    // Get the prefixes that the Web server is listening to.
    HttpListenerPrefixCollection prefixes = listener.Prefixes;
    try 
    {
        prefixes.Clear();
    } 
    // If the operation failed, return false.
    catch
    {
        return false;
    }
    return true;
}