HttpListenerContext Clase

Definición

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
HttpListenerContext

Ejemplos

En el ejemplo de código siguiente se muestra la información del usuario para 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 enviada al cliente por HttpListener, use la Response propiedad . Para obtener información del 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 usados por .HttpListenerContext La anulación de un HttpListenerContext objeto descarta la respuesta al cliente si aún no se ha enviado y libera los recursos usados por .HttpListenerContext Después de cerrar o anular un HttpListenerContext objeto, no puede hacer referencia a sus métodos ni 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)

Acepta una conexión WebSocket que especifica el subprotocolo compatible de WebSocket 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)

Se aplica a

Consulte también