HttpListenerContext Classe

Definição

Namespace:

System.Net

Assembly:

System.Net.HttpListener.dll

Origem:

HttpListenerContext.cs

Fornece acesso a objetos de solicitação e de resposta usados pela classe HttpListener. Essa classe não pode ser herdada.

public ref class HttpListenerContext sealed

public sealed class HttpListenerContext

type HttpListenerContext = class

Public NotInheritable Class HttpListenerContext

Herança

Object

HttpListenerContext

Exemplos

O exemplo de código a seguir exibe as informações do usuário para uma solicitação 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

Comentários

Essa classe fornece as informações relacionadas à solicitação HTTP (Hypertext Transfer Protocol) de um cliente que está sendo processada por um HttpListener objeto . Essa classe também tem métodos que permitem que um HttpListener objeto aceite uma conexão WebSocket.

O GetContext método retorna instâncias da HttpListenerContext classe . Para obter o objeto que representa a solicitação do cliente, use a Request propriedade . Para obter o objeto que representa a resposta que será enviada ao cliente pelo HttpListener, use a Response propriedade . Para obter informações do usuário sobre o cliente que envia a solicitação, como seu nome de logon e se ela foi autenticada, você pode consultar as propriedades no IPrincipal objeto retornado pela User propriedade .

Fechar um HttpListenerContext objeto envia a resposta ao cliente e libera todos os HttpListenerContextrecursos usados pelo . Anular um HttpListenerContext objeto descartará a resposta ao cliente se ele ainda não tiver sido enviado e liberará todos os HttpListenerContextrecursos usados pelo . Depois de fechar ou anular um HttpListenerContext objeto, você não pode referenciar seus métodos ou propriedades. Se você fizer isso, receberá uma exceção ObjectDisposedException .

Propriedades

Request	Obtém o HttpListenerRequest que representa uma solicitação do cliente para um recurso.
Response	Obtém o objeto HttpListenerResponse que será enviado ao cliente em resposta à sua solicitação.
User	Obtém um objeto usado para obter a identidade, informações de autenticação e funções de segurança para o cliente cuja solicitação é representada por este objeto HttpListenerContext.

Métodos

AcceptWebSocketAsync(String)	Aceita uma conexão de WebSocket como uma operação assíncrona.
AcceptWebSocketAsync(String, Int32, TimeSpan)	Aceite uma conexão WebSocket especificando o subprotocolo WebSocket com suporte, tamanho do buffer de recepção e o intervalo keep-alive do WebSocket como uma operação assíncrona.
AcceptWebSocketAsync(String, Int32, TimeSpan, ArraySegment<Byte>)	Aceite uma conexão WebSocket especificando o subprotocolo WebSocket com suporte, tamanho do buffer de recepção, o intervalo keep-alive do WebSocket e o buffer interno como uma operação assíncrona.
AcceptWebSocketAsync(String, TimeSpan)	Aceite uma conexão WebSocket especificando o subpro protocolo WebSocket com suporte e o intervalo keep alive do WebSocket como uma operação assíncrona.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• HttpListener
• HttpListenerRequest
• HttpListenerResponse