Método My.usuário.IsInRole

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

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

Permissões

A permissão a seguir pode ser necessária:

Para obter mais informações, consulte Segurança de Acesso de código e Solicitando permissões.

Consulte também

Tarefas

Como: Determinar se um usuário está em um AAgruparar

Demonstra Passo a passo: Implementando autenticação Personalizar e autorização

Referência

Objeto My.usuário

Enumeração BuiltInRole

Microsoft.VisualBasic.ApplicationServices.BuiltInRole

User.IsInRole