HttpListenerContext Classe

  • Referência

Definição

Namespace:
System.Net
Assembly:
System.Net.HttpListener.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Origem:
HttpListenerContext.cs
Origem:
HttpListenerContext.cs
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)

Aplica-se a

Confira também