My.User.IsInRole, méthode
Mise à jour : novembre 2007
Détermine si l'utilisateur actuel appartient au rôle spécifié.
' Usage
Dim value As Boolean = My.User.IsInRole(role)
Dim value As Boolean = My.User.IsInRole(role)
' Declaration
Public Function IsInRole( _
ByVal role As String _
) As Boolean
' -or-
Public Function IsInRole( _
ByVal role As BuiltInRole _
) As Boolean
Paramètres
- role
String ou BuiltInRole, énumération. Rôle pour lequel vérifier l'appartenance.
Valeur de retour
True si l'utilisateur actuel est un membre du rôle spécifié ; sinon, False.
Notes
La méthode My.User.IsInRole permet à votre code de déterminer si l'utilisateur actuel est un membre du rôle spécifié.
La surcharge de la méthode My.User.IsInRole qui prend une chaîne fournit un accès facile à la méthode IsInRole de l'entité de sécurité actuelle.
La surcharge de la méthode My.User.IsInRole qui prend une énumération BuiltInRole se comporte différemment, en fonction de l'entité de sécurité actuelle. S'il s'agit de l'entité de sécurité de l'utilisateur Windows (WindowsPrincipal), cette fonction convertit role vers l'énumération WindowsBuiltInRole équivalente et retourne le résultat de l'appel de IsInRole. Si l'entité de sécurité est différente, cette fonction passe le nom de la valeur d'énumération de role à la méthode IsInRole de l'entité de sécurité.
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
Pour |
Reportez-vous à |
---|---|
Déterminer le rôle de l'utilisateur |
Exemple
Cet exemple vérifie si l'utilisateur est un administrateur avant d'accéder à une ressource.
If My.User.IsInRole( _
ApplicationServices.BuiltInRole.Administrator) Then
' Insert code to access a resource here.
End If
Configuration requise
Espace de noms :Microsoft.VisualBasic.ApplicationServices
Assembly : bibliothèque Visual Basic Runtime (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 |
Autorisations
L'autorisation suivante peut être nécessaire :
Autorisation |
Description |
---|---|
Décrit un ensemble d'autorisations de sécurité appliqué au code. Énumération associée : ControlPrincipal. |
Pour plus d'informations, consultez Sécurité d'accès du code et Demande d'autorisations.
Voir aussi
Tâches
Comment : déterminer si un utilisateur est dans un groupe
Procédure pas à pas : implémentation d'une authentification et d'une autorisation personnalisées