HttpListenerContext Classe

Definição

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 (Protocolo de Transferência de Hipertexto) 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 ao 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 .

Confira também

• HttpListener
• HttpListenerRequest
• HttpListenerResponse