Método My.usuário.IsInRole

Artigo
08/25/2010

Determina se o usuário atual pertence à função especificada.

' 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

Parâmetros

role
String ou Enumeração BuiltInRole. A função para o qual você deseja verificar associação.

Valor de retorno

True Se o usuário corrente for um membro da função especificada; caso contrário, False.

Comentários

The My.User.IsInRole método permite que seu código para determinar se o usuário corrente é um membro da função especificada.

A sobrecarga do My.User.IsInRole método que usa uma cadeia de caracteres fornece fácil acesso para o IsInRole método do corrente entidade de segurança.

A sobrecarga do My.User.IsInRole método que usa um BuiltInRole enumeração se comporta de forma diferente, dependendo do corrente entidade de segurança. Se for um objeto de usuário do Windows (WindowsPrincipal), essa função converte role equivalente a WindowsBuiltInRole enumeração e retorna o resultado da chamada IsInRole. Se qualquer Outros entidade de segurança do objeto corrente, essa função passa o nome do valor de enumeração em role o principal IsInRole método.

Observação:
O comportamento exato das My.User objeto depende do tipo de aplicativo e o sistema operacional no qual o aplicativo é executado. Para obter mais informações, consulte Objeto My.usuário.

Tarefas

Para	Consulte
Determinar a função do usuário	Como: Determinar se um usuário está em um AAgruparar

Exemplo

Este exemplo verifica se o usuário é um administrador antes de acessar um recurso.

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

Requisitos

Namespace:Microsoft.VisualBasic.ApplicationServices

Classe:User, WebUser

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Disponibilidade por Tipo de Projeto

Tipo de Projeto	Disponível
Aplicativo do Windows	Sim
Biblioteca de Classe	Sim
Aplicativo de Console	Sim
Biblioteca de Controle do Windows	Sim
Biblioteca de Controle da Web	Sim
Serviço do Windows	Sim
Site	Sim