User.IsInRole 方法

定义

命名空间:

Microsoft.VisualBasic.ApplicationServices

程序集:

Microsoft.VisualBasic.Forms.dll

确定当前用户是否属于指定的角色。

重载

IsInRole(String)

确定当前用户是否属于指定的角色。

IsInRole(String)

确定当前用户是否属于指定的角色。

public:
 bool IsInRole(System::String ^ role);

public bool IsInRole (string role);

member this.IsInRole : string -> bool

Public Function IsInRole (role As String) As Boolean

参数

role

String

要检查其成员资格的角色的名称。

返回

Boolean

如果当前用户是指定角色的成员，则为 True；否则为 False。

示例

此示例在访问资源之前检查用户是否为管理员。

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

注解

方法 My.User.IsInRole 允许代码确定当前用户是否是指定角色的成员。

采用字符串的 方法的 My.User.IsInRole 重载使你能够轻松访问 IsInRole 当前主体的 方法。

采用BuiltInRole枚举的方法的My.User.IsInRole重载的行为有所不同，具体取决于当前主体。 如果它是 windows 用户主体 (WindowsPrincipal) ，则此函数将转换为 role 等效 WindowsBuiltInRole 枚举并返回调用 IsInRole的结果。 如果当前主体是任何其他主体，此函数会将 枚举值 role 的名称传递给主体的 IsInRole 方法。

注意

对象的确切行为 My.User 取决于应用程序的类型和运行应用程序的操作系统。 有关详细信息，请参阅 User 类概述。

可用性（按项目类型）

项目类型	可用
Windows 应用程序	是
类库	是
控制台应用程序	是
Windows 控件库	是
Web 控件库	是
Windows 服务	是
网站	是

另请参阅

• BuiltInRole
• 对象 (Visual Basic)