My.User (Objeto)

Artículo
10/07/2008

Actualización: noviembre 2007

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

Comentarios

Las propiedades y 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 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 tiene acceso a la aplicación.

La propiedad My.User también proporciona acceso a IPrincipal al 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 las aplicaciones para Windows, esta propiedad ofrece la misma funcionalidad que la propiedad CurrentPrincipal. En las aplicaciones Web, esta propiedad ofrece la misma funcionalidad que la propiedad User del objeto devuelto por la propiedad Current.

Nota:
En las aplicaciones para Windows, sólo los proyectos generados con la plantilla Aplicación para Windows inicializan el objeto My.User de manera predeterminada. En todos los demás tipos de proyecto de Windows, para inicializar el objeto My.User hay que llamar explícitamente a My.User.InitializeWithWindowsUser (Método) o asignar un valor a CurrentPrincipal.

Nota:
El objeto My.User no puede suministrar información sobre el usuario de Windows actual cuando se ejecuta en Windows 95 y Windows 98 porque estos sistemas operativos no admiten el concepto de usuario registrado. Para utilizar el objeto My.User en esos sistemas operativos, debe implementar la autenticación personalizada. Para obtener más información, vea Tutorial: Implementar autenticación y autorización personalizadas.

El objeto My.User no puede suministrar información sobre el usuario de Windows actual cuando se ejecuta en Windows 95 y Windows 98 porque estos sistemas operativos no admiten el concepto de usuario registrado. Para utilizar el objeto My.User en esos sistemas operativos, debe implementar la autenticación personalizada. Para obtener más información, vea Tutorial: Implementar autenticación y autorización personalizadas.

Tareas

En la tabla siguiente se muestran ejemplos de tareas en las que interviene el 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

Ejemplo

En este ejemplo se comprueba si la aplicación utiliza la autenticación Windows o autenticación personalizada, y se emplea 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