My.User.IsInRole 方法
更新:2007 年 11 月
判斷目前使用者是否屬於指定的角色。
' Usage
Dim value As Boolean = My.User.IsInRole(role)
Dim value As Boolean = My.User.IsInRole(role)
' Declaration
Public Function IsInRole( _
ByVal role As String _
) As Boolean
' -or-
Public Function IsInRole( _
ByVal role As BuiltInRole _
) As Boolean
參數
- role
String 或 BuiltInRole 列舉型別。要檢查成員資格的角色。
傳回值
如果目前使用者是指定之角色的成員則為 True,否則為 False。
備註
My.User.IsInRole 方法可以讓程式碼判斷目前使用者是否為指定之角色的成員。
My.User.IsInRole 方法之採用字串的多載提供簡易的存取方式,存取目前主體的 IsInRole 方法。
My.User.IsInRole 方法之採用 BuiltInRole 列舉型別的多載,它的作用方式會因目前主體而異。如果是 Windows 使用者主體 (WindowsPrincipal),則這個函式會將 role 轉換成對等的 WindowsBuiltInRole 列舉型別,並傳回呼叫 IsInRole 的結果。如果目前主體是其他主體,則這個函式會將 role 中之列舉值的名稱,傳到該主體的 IsInRole 方法。
注意事項: |
---|
My.User 物件的實際行為要視應用程式的類型和執行應用程式的作業系統而定。如需詳細資訊,請參閱 My.User 物件。 |
工作
若要 |
請參閱 |
---|---|
判斷使用者的角色 |
範例
這個範例會在存取資源之前,檢查使用者是否為系統管理員。
If My.User.IsInRole( _
ApplicationServices.BuiltInRole.Administrator) Then
' Insert code to access a resource here.
End If
需求
命名空間:Microsoft.VisualBasic.ApplicationServices
組件:Visual Basic 執行階段程式庫 (在 Microsoft.VisualBasic.dll 中)
依專案類型的可用性
專案類型 |
是否可用 |
---|---|
Windows 應用程式 |
可以 |
類別庫 |
可以 |
主控台應用程式 |
可以 |
Windows 控制項程式庫 |
可以 |
Web 控制項程式庫 |
可以 |
Windows 服務 |
可以 |
網站 |
可以 |
使用權限
下列使用權限可能為必要:
使用權限 |
描述 |
---|---|
描述套用至程式碼的一組安全性權限。關聯的列舉型別:ControlPrincipal。 |