Partager via


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

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

Autorisations

L'autorisation suivante peut être nécessaire :

Autorisation

Description

SecurityPermission

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

Référence

My.User, objet

BuiltInRole, énumération

Microsoft.VisualBasic.ApplicationServices.BuiltInRole

User.IsInRole