My.User.Name, propriété

Article
08/21/2008

Mise à jour : novembre 2007

Obtient le nom de l'utilisateur en cours.

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

Valeur de retour

String. Nom de l'utilisateur en cours.

Notes

Vous pouvez utiliser l'objet My.User pour obtenir des informations sur l'utilisateur en cours.

L'entité de sécurité qui authentifie l'utilisateur contrôle également le format du nom d'utilisateur. Par défaut, une application utilise l'authentification Windows, et le nom d'utilisateur a le format DOMAIN\USERNAME. Une implémentation personnalisée de l'entité de sécurité n'utilise pas forcément le même format.

Remarque :
La propriété My.User.Name retourne une chaîne vide lorsque vous utilisez Windows 95 et Windows 98 car ces systèmes d'exploitation ne reconnaissent pas les noms d'utilisateur.

Remarque :
Le comportement exact de l'objet My.User dépend du type de l'application et du système d'exploitation sur lequel s'exécute l'application. Pour plus d'informations, consultez My.User, objet.

Tâches

Le tableau suivant répertorie des exemples de tâches impliquant la propriété My.User.Name.

Pour	Consultez
Obtenir le nom de connexion de l'utilisateur	Comment : déterminer le nom de connexion d'un utilisateur
Obtenir le nom de domaine de l'utilisateur, si l'application utilise l'authentification Windows	Comment : déterminer le domaine de l'utilisateur
Implémenter l'authentification personnalisée	Procédure pas à pas : implémentation d'une authentification et d'une autorisation personnalisées

Exemple

Cet exemple vérifie si l'application utilise l'authentification Windows ou une authentification personnalisée, et utilise ces informations pour analyser la propriété 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

Configuration requise

Espace de noms :Microsoft.VisualBasic.ApplicationServices

Classe :User, WebUser

Assembly : bibliothèque runtime Visual Basic (dans Microsoft.VisualBasic.dll)

Disponibilité par type de projet

Type de projet	Disponible
Application Windows	Oui
Bibliothèque de classes	Oui
Application console	Oui
Bibliothèque de contrôles Windows	Oui
Bibliothèque de contrôles Web	Oui
Service Windows	Oui
Site Web	Oui