Metodo My.User.IsInRole

Articolo
09/12/2008

Aggiornamento: novembre 2007

Consente di determinare se l'utente corrente appartiene al ruolo specificato.

' 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

Parametri

role
String o Enumerazione BuiltInRole. Ruolo per il quale verificare l'appartenenza.

Valore restituito

True se l'utente corrente è un membro del ruolo specificato, altrimenti False.

Note

Il metodo My.User.IsInRole consente al codice di determinare se l'utente corrente è un membro del ruolo specificato.

L'overload del metodo My.User.IsInRole che accetta una stringa fornisce un facile accesso al metodo IsInRole dell'entità corrente.

L'overload del metodo My.User.IsInRole che accetta un'enumerazione BuiltInRole invece, si comporta diversamente in base all'entità corrente. Se si tratta di un'entità utente di Windows (WindowsPrincipal), questa funzione converte role nell'enumerazione WindowsBuiltInRole equivalente e restituisce il risultato del ruolo IsInRole chiamante. Se l'entità corrente corrisponde a un'altra entità, questa funzione passa il nome del valore di enumerazione in role al metodo IsInRole dell'entità.

Nota:
Il comportamento esatto dell'oggetto My.User dipende dal tipo di applicazione e dal sistema operativo su cui questa viene eseguita. Per ulteriori informazioni, vedere Oggetto My.User.

Attività

Per	Vedere
Determinare il ruolo dell'utente	Procedura: determinare l'appartenenza di un utente a un gruppo

Esempio

In questo esempio viene verificato se l'utente è un amministratore prima che possa accedere a una risorsa.

If My.User.IsInRole( _
        ApplicationServices.BuiltInRole.Administrator) Then
    ' Insert code to access a resource here.
End If

Requisiti

Spazio dei nomi:Microsoft.VisualBasic.ApplicationServices

Classe:User, WebUser

Assembly: libreria di runtime di Visual Basic (in Microsoft.VisualBasic.dll)

Disponibilità per tipo di progetto

Tipo di progetto	Disponibile
Applicazione Windows	Sì
Libreria di classi	Sì
Applicazione di console	Sì
Libreria di controlli Windows	Sì
Libreria di controlli Web	Sì
Servizio Windows	Sì
Sito Web	Sì