HttpListenerContext Classe

  • Referência

Definição

Namespace:
System.Net
Assembly:
System.Net.HttpListener.dll
Assembly:
System.dll
Assembly:
netstandard.dll

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 está enviando 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 para o cliente e libera todos os recursos usados pelo HttpListenerContext. 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 subprotocolo 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)

Aplica-se a

Confira também