HttpListenerContext Clase

Definición

Espacio de nombres:

System.Net

Ensamblado:

System.Net.HttpListener.dll

Source:

HttpListenerContext.cs

Proporciona acceso a los objetos de solicitud y respuesta utilizados por la clase HttpListener. Esta clase no puede heredarse.

public ref class HttpListenerContext sealed

public sealed class HttpListenerContext

type HttpListenerContext = class

Public NotInheritable Class HttpListenerContext

Herencia

Object

HttpListenerContext

Ejemplos

En el ejemplo de código siguiente se muestra la información de usuario de una solicitud de cliente.

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

Comentarios

Esta clase proporciona la información relacionada con la solicitud del Protocolo de transferencia de hipertexto (HTTP) de un cliente que procesa un HttpListener objeto . Esta clase también tiene métodos que permiten a un HttpListener objeto aceptar una conexión WebSocket.

El GetContext método devuelve instancias de la HttpListenerContext clase . Para obtener el objeto que representa la solicitud de cliente, use la Request propiedad . Para obtener el objeto que representa la respuesta que se enviará al cliente mediante HttpListener, use la Response propiedad . Para obtener información de usuario sobre el cliente que envía la solicitud, como su nombre de inicio de sesión y si se ha autenticado, puede consultar las propiedades en el IPrincipal objeto devuelto por la User propiedad .

Al cerrar un HttpListenerContext objeto, se envía la respuesta al cliente y se liberan los recursos utilizados por .HttpListenerContext Al anular un HttpListenerContext objeto, se descarta la respuesta al cliente si aún no se ha enviado y se liberan los recursos utilizados por HttpListenerContext. Después de cerrar o anular un HttpListenerContext objeto, no se puede hacer referencia a sus métodos o propiedades. Si lo hace, recibirá una ObjectDisposedException excepción.

Propiedades

Request	Obtiene la clase HttpListenerRequest que representa la solicitud de un cliente para un recurso.
Response	Obtiene el objeto HttpListenerResponse que se enviará al cliente en respuesta a la solicitud del cliente.
User	Obtiene un objeto utilizado para obtener la identidad, la información de autenticación y los roles de seguridad para el cliente cuya solicitud está representada por este objeto HttpListenerContext.

Métodos

AcceptWebSocketAsync(String)	Acepta una conexión WebSocket como una operación asincrónica.
AcceptWebSocketAsync(String, Int32, TimeSpan)	Acepta una conexión WebSocket que especifica el subprotocolo compatible de WebSocket, el tamaño del búfer de recepción y el intervalo keep-alive de WebSocket como una operación asincrónica.
AcceptWebSocketAsync(String, Int32, TimeSpan, ArraySegment<Byte>)	Acepta una conexión WebSocket que especifica el subprotocolo compatible de WebSocket, el tamaño del búfer de recepción, el intervalo keep-alive de WebSocket y el búfer interno como una operación asincrónica.
AcceptWebSocketAsync(String, TimeSpan)	Acepte una conexión de WebSocket que especifique el subprotocolo WebSocket admitido y el intervalo keep-alive de WebSocket como una operación asincrónica.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Consulte también

• HttpListener
• HttpListenerRequest
• HttpListenerResponse