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

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

Autorisations

L'autorisation suivante peut être nécessaire :

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

Référence

My.User, objet

BuiltInRole, énumération

Microsoft.VisualBasic.ApplicationServices.BuiltInRole

User.IsInRole