User.IsInRole 方法

  • 参考

定义

命名空间:
Microsoft.VisualBasic.ApplicationServices
程序集:
Microsoft.VisualBasic.dll
程序集:
Microsoft.VisualBasic.Forms.dll

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

重载

IsInRole(BuiltInRole)

确定当前用户是否属于指定的角色。
IsInRole(String)

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

IsInRole(BuiltInRole)

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

public:
 bool IsInRole(Microsoft::VisualBasic::ApplicationServices::BuiltInRole role);
public bool IsInRole (Microsoft.VisualBasic.ApplicationServices.BuiltInRole role);
member this.IsInRole : Microsoft.VisualBasic.ApplicationServices.BuiltInRole -> bool
Public Function IsInRole (role As BuiltInRole) As Boolean

参数

role
BuiltInRole

要检查其成员资格的内置 Windows 角色。

返回

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 服务 是
网站 是

另请参阅

适用于

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 服务 是
网站 是

另请参阅

适用于