My.User, objet

Article
09/12/2008

Mise à jour : novembre 2007

Permet d'accéder aux informations concernant l'utilisateur actuel.

Notes

Les propriétés et les méthodes exposées par l'objet My.User permettent d'accéder aux informations concernant l'utilisateur actuel. La signification de l'expression « utilisateur actuel » est sensiblement différente selon que vous utilisez une application Windows ou une application Web. Dans une application Windows, l'utilisateur actuel est l'utilisateur qui exécute l'application. Dans une application Web, l'utilisateur actuel est l'utilisateur qui accède à l'application.

La propriété My.User permet également d'accéder au IPrincipal pour l'utilisateur actuel. Un objet principal représente le contexte de sécurité de l'utilisateur, y compris l'identité de cet utilisateur et les rôles auxquels il appartient.

Pour les applications Windows, cette propriété fournit les mêmes fonctionnalités que la propriété CurrentPrincipal. Pour les applications Web, cette propriété fournit les mêmes fonctionnalités que la propriété User de l'objet retourné par la propriété Current.

Remarque :
Pour les applications Windows, seuls les projets intégrés dans le modèle Application Windows initialisent l'objet My.User par défaut. Dans tous les autres types de projet Windows, vous devez initialiser l'objet My.User en appelant explicitement la méthode My.User.InitializeWithWindowsUser ou en assignant une valeur à CurrentPrincipal.

Remarque :
L'objet My.User ne peut pas rapporter des informations sur l'utilisateur Windows actuel lorsqu'il est exécuté sous Windows 95 et Windows 98 parce que ces systèmes d'exploitation ne prennent pas en charge le concept d'un utilisateur connecté. Pour pouvoir utiliser l'objet My.User sur ces systèmes d'exploitation, vous devez implémenter une authentification personnalisée. Pour plus d'informations, consultez Procédure pas à pas : implémentation d'une authentification et d'une autorisation personnalisées.

L'objet My.User ne peut pas rapporter des informations sur l'utilisateur Windows actuel lorsqu'il est exécuté sous Windows 95 et Windows 98 parce que ces systèmes d'exploitation ne prennent pas en charge le concept d'un utilisateur connecté. Pour pouvoir utiliser l'objet My.User sur ces systèmes d'exploitation, vous devez implémenter une authentification personnalisée. Pour plus d'informations, consultez Procédure pas à pas : implémentation d'une authentification et d'une autorisation personnalisées.

Tâches

Le tableau suivant répertorie des exemples de tâches impliquant l'objet My.User.

Pour	Reportez-vous à
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
Déterminer le rôle de l'utilisateur	Comment : déterminer si un utilisateur est dans un groupe
Implémenter une 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 une authentification personnalisée ou Windows 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