My.User.IsInRole (Método)

Actualización: noviembre 2007

Determina si el usuario actual pertenece a la función 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 o BuiltInRole (Enumeración) Función cuya pertenencia se va a comprobar.

Valor devuelto

True si el usuario actual es un miembro de la función especificada; de lo contrario, False.

Comentarios

El método My.User.IsInRole permite al código determinar si el usuario actual es un miembro de la función especificada.

La sobrecarga del método My.User.IsInRole que toma una cadena proporciona acceso fácil al método IsInRole del principal actual.

La sobrecarga del método My.User.IsInRole que toma una enumeración BuiltInRole se comporta de manera diferente según el principal actual. Si es un principal de usuario de Windows (WindowsPrincipal), esta función convierte role en la enumeración WindowsBuiltInRole equivalente y devuelve el resultado de llamar a IsInRole. Si el principal actual es cualquier otro, esta función pasa el nombre del valor de enumeración de role al método IsInRole del principal.

Nota:
El comportamiento exacto del objeto My.User depende del tipo de aplicación y del sistema operativo en el que se ejecuta la aplicación. Para obtener más información, vea My.User (Objeto).

Tareas

Ejemplo

En este ejemplo se comprueba si el usuario es un administrador antes de tener acceso a un recurso.

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

Requisitos

Espacio de nombres:Microsoft.VisualBasic.ApplicationServices

Clase:User, WebUser

Ensamblado: biblioteca en tiempo de ejecución de Visual Basic (en Microsoft.VisualBasic.dll)

Disponibilidad por tipo de proyecto

Permisos

El permiso siguiente puede ser necesario:

Para obtener más información, vea Seguridad de acceso a código y Solicitar permisos.

Vea también

Tareas

Cómo: Determinar si un usuario está en un grupo

Tutorial: Implementar autenticación y autorización personalizadas

Referencia

My.User (Objeto)

BuiltInRole (Enumeración)

Microsoft.VisualBasic.ApplicationServices.BuiltInRole

User.IsInRole