HttpListenerContext.User (Propiedad) (System.Net)

User (Propiedad)

Contraer todo

Filtro de lenguage

Esta página es específica de

Microsoft Visual Studio 2005/.NET Framework 2.0

Hay además otras versiones disponibles para:

Biblioteca de clases de .NET Framework

HttpListenerContext.User (Propiedad)

Nota: esta propiedad es nueva en la versión 2.0 de .NET Framework.

Obtiene un objeto utilizado para obtener la identidad, la información de autenticación y las funciones de seguridad para el cliente cuya solicitud está representada por este objeto HttpListenerContext.

Espacio de nombres: System.Net
Ensamblado: System (en system.dll)

Sintaxis

Visual Basic (Declaración)

Public ReadOnly Property User As IPrincipal

Visual Basic (Uso)

Dim instance As HttpListenerContext
Dim value As IPrincipal

value = instance.User

public IPrincipal User { get; }

C++

public:
property IPrincipal^ User {
    IPrincipal^ get ();
}

/** @property */
public IPrincipal get_User ()

JScript

public function get User () : IPrincipal

Valor de propiedad

Un objeto IPrincipal que describe el cliente o bien referencia de objeto null (Nothing en Visual Basic), si el objeto HttpListener que proporcionó HttpListenerContext no requiere autenticación.

Comentarios

Un objeto HttpListener indica que requiere autenticación mediante la propiedad AuthenticationSchemes o especificando un delegado de AuthenticationSchemeSelector mediante la propiedad AuthenticationSchemeSelectorDelegate.

Para averiguar el nombre de inicio de sesión del cliente y la información de autenticación, compruebe la propiedad IPrincipal.Identity en el objeto devuelto por esta propiedad.

Ejemplo

En el ejemplo de código siguiente se muestra cómo obtener acceso a la identidad e información de autenticación del cliente, y cómo devolverla al cliente en la respuesta.

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;
}