WebUser 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
提供關於當前使用者資訊的存取權限。
public ref class WebUser : Microsoft::VisualBasic::ApplicationServices::User
public class WebUser : Microsoft.VisualBasic.ApplicationServices.User
type WebUser = class
inherit User
Public Class WebUser
Inherits 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 與網頁應用程式間略有差異。 在 Windows 應用程式中,當前使用者是執行該應用程式的使用者。 在網頁應用程式中,目前的使用者就是存取該應用程式的使用者。
該 My.User 物業也為現有使用者提供存取權限 IPrincipal 。 主物件代表使用者的安全情境,包括該使用者的身份以及所屬的角色。
對於 Windows 應用程式,此屬性提供與該 CurrentPrincipal 屬性相同的功能。 對於網頁應用程式而言,此屬性提供與 User 該 Current 物件所回傳屬性相同的功能。
備註
對於 Windows 應用程式,只有基於 Windows 應用程式 範本所建構的專案預設會初始化物件 My.User 。 在所有其他 Windows 專案類型中,你必須透過明確呼叫InitializeWithWindowsUser該方法或指派值來CurrentPrincipal初始My.User化物件。
建構函式
| 名稱 | Description |
|---|---|
| WebUser() |
初始化 WebUser 類別的新執行個體。 |
屬性
| 名稱 | Description |
|---|---|
| CurrentPrincipal |
取得或設定目前的原則(用於基於角色的安全性)。 (繼承來源 User) |
| InternalPrincipal |
取得或設定代表當前使用者的主要物件。 |
| IsAuthenticated |
會得到一個表示使用者是否已被認證的值。 (繼承來源 User) |
| Name |
會取得目前使用者的名字。 (繼承來源 User) |
方法
| 名稱 | Description |
|---|---|
| Equals(Object) |
判斷指定的物件是否等於目前的物件。 (繼承來源 Object) |
| GetHashCode() |
做為預設哈希函式。 (繼承來源 Object) |
| GetType() |
取得目前實例的 Type。 (繼承來源 Object) |
| InitializeWithWindowsUser() |
將執行緒目前的主體設定為啟動該應用程式的 Windows 使用者。 (繼承來源 User) |
| IsInRole(BuiltInRole) |
判斷目前使用者是否屬於指定角色。 (繼承來源 User) |
| IsInRole(String) |
判斷目前使用者是否屬於指定角色。 (繼承來源 User) |
| MemberwiseClone() |
建立目前 Object的淺層複本。 (繼承來源 Object) |
| ToString() |
傳回表示目前 物件的字串。 (繼承來源 Object) |