Esta documentación está archivada y no tiene mantenimiento.

User (Clase)

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

Proporciona acceso a la información sobre el usuario actual.

Espacio de nombres: Microsoft.VisualBasic.ApplicationServices
Ensamblado: Microsoft.VisualBasic (en microsoft.visualbasic.dll)

public class User
public class User
public class User

Para obtener información más detallada, vea el tema My.User (Objeto) de Visual Basic.

Las propiedades y los métodos expuestos por el objeto My.User proporcionan acceso a la información sobre el usuario actual. El significado de "usuario actual" difiere ligeramente entre las aplicaciones para Windows y las aplicaciones Web. En una aplicación para Windows, el usuario actual es el usuario que ejecuta la aplicación. En una aplicación Web, el usuario actual es el usuario que obtiene acceso a la aplicación.

La propiedad My.User también proporciona acceso a la interfaz IPrincipal del usuario actual. Un objeto principal representa el contexto de seguridad del usuario, incluidas la identidad de ese usuario y las funciones a las que pertenece el usuario.

En el caso de las aplicaciones para Windows, esta propiedad proporciona la misma funcionalidad que la propiedad CurrentPrincipal. En el caso de las aplicaciones Web, esta propiedad proporciona la misma funcionalidad que la propiedad User del objeto devuelto por la propiedad Current.

NotaNota

En el caso de las aplicaciones para Windows, sólo los proyectos generados en la plantilla Aplicación para Windows inicializan de manera predeterminada el objeto My.User. En todos los demás tipos de proyecto de Windows, se debe inicializar el objeto My.User llamando explícitamente a My.User.InitializeWithWindowsUser (Método) o asignando un valor a CurrentPrincipal.

NotaNota

El objeto My.User no puede proporcionar información sobre el usuario actual de Windows cuando se ejecuta en Windows 95 y Windows 98 dado que esos sistemas operativos no admiten el concepto de usuario que ha iniciado sesión. Es preciso implementar la autenticación personalizada para poder utilizar el objeto My.User en esos sistemas operativos. Para obtener más información, vea Tutorial: Implementar autenticación y autorización personalizadas.

La tabla siguiente recoge ejemplos de tareas que implican al objeto My.User.

Para

Vea

Obtener el nombre de inicio de sesión del usuario.

Cómo: Determinar el nombre de inicio de sesión de un usuario

Obtener el nombre de dominio del usuario si la aplicación utiliza la autenticación de Windows.

Cómo: Determinar el dominio del usuario

Determinar la función del usuario.

Cómo: Determinar si un usuario está en un grupo

Implementar la autenticación personalizada

Tutorial: Implementar autenticación y autorización personalizadas

En este ejemplo se comprueba si la aplicación utiliza la autenticación de Windows o una autenticación personalizada, y se utiliza esa información para analizar la propiedad My.User.Name.

Function GetUserName() As String
    If TypeOf My.User.CurrentPrincipal Is _
    Security.Principal.WindowsPrincipal Then
        ' The application is using Windows authentication.
        ' The name format is DOMAIN\USERNAME.
        Dim parts() As String = Split(My.User.Name, "\")
        Dim username As String = parts(1)
        Return username
    Else
        ' The application is using custom authentication.
        Return My.User.Name
    End If
End Function

System.Object
  Microsoft.VisualBasic.ApplicationServices.User
     Microsoft.VisualBasic.ApplicationServices.WebUser

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows 98, Windows 2000 SP4, Windows Millennium, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

.NET Framework

Compatible con: 2.0
Mostrar: