HttpListenerContext Classe

Definição

Espaço de Nomes:
System.Net
Assemblagem:
System.dll
Assemblagem:
netstandard.dll

Fornece acesso aos objetos de pedido e resposta usados pela HttpListener classe. Esta 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 seguinte mostra a informação do utilizador para um pedido 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

Observações

Esta classe fornece a informação relacionada com o pedido do Protocolo de Transferência de Hipertexto (HTTP) de um cliente a ser processado por um HttpListener objeto. Esta classe também possui métodos que permitem a um HttpListener objeto aceitar uma ligação WebSocket.

O GetContext método devolve instâncias da HttpListenerContext classe. Para obter o objeto que representa o pedido 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 utilizador sobre o cliente que enviou o pedido, como o seu nome de login e se foi autenticado, pode consultar as propriedades no IPrincipal objeto devolvido pela User propriedade.

Fechar um HttpListenerContext objeto envia a resposta ao cliente e liberta quaisquer recursos usados pelo HttpListenerContext. Abortar um HttpListenerContext objeto descarta a resposta ao cliente se ainda não tiver sido enviada, e liberta quaisquer recursos usados pelo HttpListenerContext. Depois de fechar ou abortar um HttpListenerContext objeto, não pode referenciar os seus métodos ou propriedades. Se o fizer, receberá uma ObjectDisposedException exceção.

Propriedades

Name Description
Request

Obtém-se que HttpListenerRequest representa o pedido de um cliente para um recurso.
Response

Recebe o HttpListenerResponse objeto que será enviado ao cliente em resposta ao pedido do cliente.
User

Obtém um objeto usado para obter identidade, informações de autenticação e funções de segurança para o cliente cujo pedido é representado por este HttpListenerContext objeto.

Métodos

Name Description
AcceptWebSocketAsync(String, Int32, TimeSpan, ArraySegment<Byte>)

Aceitar uma ligação WebSocket que especifique o subprotocolo WebSocket suportado, o tamanho do buffer de receção, o intervalo WebSocket keep-alive e o buffer interno como uma operação assíncrona.
AcceptWebSocketAsync(String, Int32, TimeSpan)

Aceitar uma ligação WebSocket que especifique o subprotocolo WebSocket suportado, o tamanho do buffer de receção e o intervalo de manutenção WebSocket como uma operação assíncrona.
AcceptWebSocketAsync(String, TimeSpan)

Aceitar uma ligação WebSocket que especifique o subprotocolo WebSocket suportado e o intervalo WebSocket keep-alive como uma operação assíncrona.
AcceptWebSocketAsync(String)

Aceitar uma ligação WebSocket como uma operação assíncrona.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também