User 类

  • 参考

定义

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

提供对有关当前用户的信息的访问。

public ref class User
public class User
type User = class
Public Class User
继承
Object
User
派生

示例

此示例检查应用程序是否使用 Windows 或自定义身份验证，并使用该信息来分析 My.User.Name 属性。

Function GetUserName() As String
    If TypeOf My.User.CurrentPrincipal Is 
      Security.Principal.WindowsPrincipal Then
        ' The application is using Windows authentication.
        ' The name format is DOMAIN\USERNAME.
        Dim parts() As String = Split(My.User.Name, "\")
        Dim username As String = parts(1)
        Return username
    Else
        ' The application is using custom authentication.
        Return My.User.Name
    End If
End Function

注解

对象公开 My.User 的属性和方法提供对当前用户相关信息的访问。 Windows 和 Web 应用程序之间“当前用户”的含义略有不同。 在 Windows 应用程序中，当前用户是运行该应用程序的用户。 在 Web 应用程序中，当前用户是访问应用程序的用户。

属性 My.User 还提供对当前用户的访问权限 IPrincipal 。 主体对象表示用户的安全上下文，包括该用户的身份和用户所属的任何角色。

对于 Windows 应用程序，此属性提供与 属性相同的功能 CurrentPrincipal 。 对于 Web 应用程序，此属性提供的功能与 User 属性返回 Current 的 对象的 属性相同。

注意

对于 Windows 应用程序，默认情况下，只有基于 Windows 应用程序 模板生成的项目才会初始化 My.User 对象。 在所有其他 Windows 项目类型中 My.User ，必须通过显式调用 InitializeWithWindowsUser 方法或将值分配给 CurrentPrincipal来初始化 对象。

构造函数

User()

初始化 User 类的新实例。

属性

CurrentPrincipal

获取或设置当前主体（对基于角色的安全性而言）。
InternalPrincipal

获取或设置表示当前用户的主体对象。
IsAuthenticated

获取一个值，该值指示是否验证了用户。
Name

获取当前用户的名称。

方法

Equals(Object)

确定指定对象是否等于当前对象。

(继承自 Object)
GetHashCode()

作为默认哈希函数。

(继承自 Object)
GetType()

获取当前实例的 Type。

(继承自 Object)
InitializeWithWindowsUser()

将线程的当前主体设置为启动应用程序的 Windows 用户。
IsInRole(BuiltInRole)

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

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

创建当前 Object 的浅表副本。

(继承自 Object)
ToString()

返回表示当前对象的字符串。

(继承自 Object)

适用于

另请参阅