My.User.Name 屬性

發行項
08/21/2008

更新：2007 年 11 月

取得目前使用者的名稱。

 ' Usage Dim value As String = My.User.Name ' Declaration Public ReadOnly Property Name As String

傳回值

String。目前使用者的名稱。

備註

您可以使用 My.User 物件，取得目前使用者的資訊。

驗證使用者的主體也會控制使用者名稱的格式。根據預設，應用程式會使用 Windows 驗證，且使用者名稱的格式為 DOMAIN\USERNAME。主體的自訂實作不一定要使用相同的格式。

注意事項：
在 Windows 95 和 Windows 98 上執行時，因為這些作業系統無法辨認使用者名稱，所以 My.User.Name 屬性會傳回空字串。

注意事項：
My.User 物件的確實行為會取決於應用程式的類型和執行應用程式的作業系統。如需詳細資訊，請參閱 My.User 物件。

工作

下表列出包含 My.User.Name 屬性的工作範例。

若要	請參閱
取得使用者的登入名稱	HOW TO：判斷使用者的登入名稱
取得使用者的網域名稱 (如果應用程式使用 Windows 驗證)	HOW TO：判斷使用者的網域
實作自訂驗證	逐步解說：實作自訂驗證和授權

範例

這個範例會檢查應用程式是使用 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