My.User.IsInRole, méthode

Article
08/21/2008

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	Comment : déterminer si un utilisateur est dans un groupe

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

Classe :User, WebUser

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