User 類別

定義

命名空間:

Microsoft.VisualBasic.ApplicationServices

組件:

Microsoft.VisualBasic.Forms.dll

提供目前使用者相關資訊的存取。

public ref class User

public class User

type User = class

Public Class User

繼承

Object

User

衍生

Microsoft.VisualBasic.ApplicationServices.WebUser

範例

此範例會檢查應用程式是否使用 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 應用程式，這個屬性提供與 屬性所Current傳回之 對象的 屬性相同的功能User。

注意

針對 Windows 應用程式，只有建置在 Windows 應用程式 範本上的專案預設會初始化 My.User 物件。 在所有其他 Windows 項目類型中，您必須明確呼叫 InitializeWithWindowsUser 方法，或將值指派給 CurrentPrincipal來初始化 My.User 物件。

建構函式

User()

初始化 User 類別的新執行個體。

屬性

CurrentPrincipal	取得或設定目前主體 (以角色為基礎的安全性之用)。
InternalPrincipal	取得或設定 Principal 物件，表示目前使用者。
IsAuthenticated	取得值，表示使用者是否已經驗證。
Name	取得目前使用者的名稱。

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IsInRole(String)	判斷目前的使用者是否屬於指定的角色。
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• IPrincipal
• CurrentPrincipal
• User
• Current
• 物件 (Visual Basic)