My.User.Name (Propiedad)

Artículo
08/23/2008

Actualización: noviembre 2007

Obtiene el nombre del usuario actual.

' Usage
Dim value As String = My.User.Name
' Declaration
Public ReadOnly Property Name As String

Valor devuelto

String. El nombre del usuario actual.

Comentarios

Puede utilizar el objeto My.User para obtener información sobre el usuario actual.

El objeto principal que autentica al usuario también controla el formato del nombre de usuario. De manera predeterminada, las aplicaciones utilizan la autenticación de Windows y el nombre de usuario tiene el formato DOMINIO\NOMBREUSUARIO. Una implementación personalizada del objeto principal no utiliza necesariamente el mismo formato.

Nota:
La propiedad My.User.Name devuelve una cadena vacía cuando se ejecuta en Windows 95 y Windows 98 porque estos sistemas operativos no reconocen los nombres de usuario.

Nota:
El comportamiento exacto del objeto My.User depende del tipo de la aplicación y del sistema operativo donde se ejecute la aplicación. Para obtener más información, vea My.User (Objeto).

Tareas

La tabla siguiente muestra una lista de ejemplos de tareas en las que está implicada la propiedad My.User.Name.

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
Implementar una autenticación personalizada	Tutorial: Implementar autenticación y autorización personalizadas

Ejemplo

Este ejemplo comprueba si la aplicación utiliza la autenticación de Windows o personalizada y emplea esta 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

Requisitos

Espacio de nombres:Microsoft.VisualBasic.ApplicationServices

Clase:User, WebUser

Ensamblado: biblioteca en tiempo de ejecución de Visual Basic (en Microsoft.VisualBasic.dll)

Disponibilidad por tipo de proyecto

Tipo de proyecto	Disponible
Aplicación para Windows	Sí
Biblioteca de clases	Sí
Aplicación de consola	Sí
Biblioteca de controles de Windows	Sí
Biblioteca de controles Web	Sí
Servicio de Windows	Sí
Sitio Web	Sí