User Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit l’accès aux informations relatives à l’utilisateur actuel.
public ref class User
public class User
type User = class
Public Class User
- Héritage
-
User
- Dérivé
Exemples
Cet exemple vérifie si l’application utilise l’authentification Windows ou personnalisée et utilise ces informations pour analyser la My.User.Name propriété.
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
Remarques
Les propriétés et méthodes exposées par l’objet My.User fournissent l’accès aux informations relatives à l’utilisateur actuel. La signification de « l’utilisateur actuel » diffère légèrement entre les applications Windows et 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 My.User propriété fournit également l’accès à l’utilisateur IPrincipal actuel. Un objet principal représente le contexte de sécurité de l’utilisateur, y compris l’identité de cet utilisateur et tous les rôles auxquels appartient l’utilisateur.
Pour les applications Windows, cette propriété fournit les mêmes fonctionnalités que la CurrentPrincipal propriété. Pour les applications web, cette propriété fournit les mêmes fonctionnalités que la User propriété de l’objet retourné par la Current propriété.
Note
Pour les applications Windows, seuls les projets basés sur le modèle d’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 InitializeWithWindowsUser méthode ou en affectant une valeur à CurrentPrincipal.
Constructeurs
| Nom | Description |
|---|---|
| User() |
Initialise une nouvelle instance de la classe User. |
Propriétés
| Nom | Description |
|---|---|
| CurrentPrincipal |
Obtient ou définit le principal actuel (pour la sécurité basée sur les rôles). |
| InternalPrincipal |
Obtient ou définit l’objet principal représentant l’utilisateur actuel. |
| IsAuthenticated |
Obtient une valeur qui indique si l’utilisateur a été authentifié. |
| Name |
Obtient le nom de l’utilisateur actuel. |
Méthodes
| Nom | Description |
|---|---|
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| InitializeWithWindowsUser() |
Définit le principal actuel du thread sur l’utilisateur Windows qui a démarré l’application. |
| IsInRole(BuiltInRole) |
Détermine si l’utilisateur actuel appartient au rôle spécifié. |
| IsInRole(String) |
Détermine si l’utilisateur actuel appartient au rôle spécifié. |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |