HttpListenerContext クラス

定義

public ref class HttpListenerContext sealed

public sealed class HttpListenerContext

type HttpListenerContext = class

Public NotInheritable Class HttpListenerContext

継承

Object

HttpListenerContext

例

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

public static string ClientInformation(HttpListenerContext context)
{
    System.Security.Principal.IPrincipal user = context.User;
    System.Security.Principal.IIdentity id = user.Identity;
    if (id == null)
    {
        return "Client authentication is not enabled for this Web server.";
    }

    string display;
    if (id.IsAuthenticated)
    {
        display = String.Format("{0} was authenticated using {1}", id.Name,
            id.AuthenticationType);
    }
    else
    {
       display = String.Format("{0} was not authenticated", id.Name);
    }
    return display;
}

Public Shared Function ClientInformation(ByVal context As HttpListenerContext) As String
    Dim user As System.Security.Principal.IPrincipal = context.User
    Dim id As System.Security.Principal.IIdentity = user.Identity

    If id Is Nothing Then
        Return "Client authentication is not enabled for this Web server."
    End If

    Dim display As String

    If id.IsAuthenticated Then
        display = String.Format("{0} was authenticated using {1}", id.Name, id.AuthenticationType)
    Else
        display = String.Format("{0} was not authenticated", id.Name)
    End If

    Return display
End Function

注釈

このクラスは、オブジェクトによって処理されるクライアントのハイパーテキスト転送プロトコル (HTTP) 要求に関連する情報を HttpListener 提供します。 このクラスには、オブジェクトが WebSocket 接続を HttpListener 受け入れられるメソッドもあります。

メソッドは GetContext 、 クラスのインスタンスを HttpListenerContext 返します。 クライアント要求を表す オブジェクトを取得するには、 プロパティを Request 使用します。 によって HttpListenerクライアントに送信される応答を表す オブジェクトを取得するには、 プロパティを Response 使用します。 ログイン名や認証されているかどうかなど、要求を送信するクライアントに関するユーザー情報を取得するには、 プロパティによって返されるオブジェクトの IPrincipal プロパティに対してクエリを User 実行します。

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

プロパティ

メソッド

適用対象

こちらもご覧ください

• HttpListener
• HttpListenerRequest
• HttpListenerResponse