User.IsInRole 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
判斷目前的使用者是否屬於指定的角色。
多載
| IsInRole(BuiltInRole) |
判斷目前的使用者是否屬於指定的角色。 |
| IsInRole(String) |
判斷目前的使用者是否屬於指定的角色。 |
IsInRole(BuiltInRole)
判斷目前的使用者是否屬於指定的角色。
public:
bool IsInRole(Microsoft::VisualBasic::ApplicationServices::BuiltInRole role);
public bool IsInRole(Microsoft.VisualBasic.ApplicationServices.BuiltInRole role);
member this.IsInRole : Microsoft.VisualBasic.ApplicationServices.BuiltInRole -> bool
Public Function IsInRole (role As BuiltInRole) As Boolean
參數
- role
- BuiltInRole
要檢查其成員資格的內建 Windows 角色。
傳回
如果目前使用者是指定角色的成員則為 True,否則為 False。
範例
此範例會先檢查使用者是否為系統管理員,再存取資源。
If My.User.IsInRole(
ApplicationServices.BuiltInRole.Administrator) Then
' Insert code to access a resource here.
End If
備註
方法 My.User.IsInRole 可讓您的程式代碼判斷目前的使用者是否為指定角色的成員。
接受字串之 方法的多 My.User.IsInRole 載可讓您輕鬆存取 IsInRole 目前主體的方法。
採用BuiltInRole列舉的方法多My.User.IsInRole載會根據目前的主體而有不同的行為。 如果它是 Windows 用戶主體 (WindowsPrincipal) ,此函式會 role 轉換成對等 WindowsBuiltInRole 的列舉,並傳回呼叫 IsInRole的結果。 如果目前的主體是任何其他主體,此函式會將 列舉 role 值的名稱傳遞給主體的 IsInRole 方法。
注意
對象的確切行為 My.User 取決於應用程式的類型,以及應用程式執行所在的操作系統。 如需詳細資訊,請參閱 類別概 User 觀。
依專案類型的可用性
| 專案類型 | 可用 |
|---|---|
| Windows 應用程式 | 是 |
| 類別庫 | 是 |
| 主控台應用程式 | 是 |
| Windows 控制項程式庫 | 是 |
| Web 控制項程式庫 | 是 |
| Windows 服務 | 是 |
| 網站 | 是 |
另請參閱
適用於
IsInRole(String)
- 來源:
- User.vb
- 來源:
- User.vb
- 來源:
- User.vb
- 來源:
- User.vb
判斷目前的使用者是否屬於指定的角色。
public:
bool IsInRole(System::String ^ role);
public bool IsInRole(string role);
member this.IsInRole : string -> bool
Public Function IsInRole (role As String) As Boolean
參數
- role
- String
用來檢查成員資格的角色名稱。
傳回
如果目前使用者是指定角色的成員則為 True,否則為 False。
範例
此範例會先檢查使用者是否為系統管理員,再存取資源。
If My.User.IsInRole(
ApplicationServices.BuiltInRole.Administrator) Then
' Insert code to access a resource here.
End If
備註
方法 My.User.IsInRole 可讓您的程式代碼判斷目前的使用者是否為指定角色的成員。
接受字串之 方法的多 My.User.IsInRole 載可讓您輕鬆存取 IsInRole 目前主體的方法。
採用BuiltInRole列舉的方法多My.User.IsInRole載會根據目前的主體而有不同的行為。 如果它是 Windows 用戶主體 (WindowsPrincipal) ,此函式會 role 轉換成對等 WindowsBuiltInRole 的列舉,並傳回呼叫 IsInRole的結果。 如果目前的主體是任何其他主體,此函式會將 列舉 role 值的名稱傳遞給主體的 IsInRole 方法。
注意
對象的確切行為 My.User 取決於應用程式的類型,以及應用程式執行所在的操作系統。 如需詳細資訊,請參閱 類別概 User 觀。
依專案類型的可用性
| 專案類型 | 可用 |
|---|---|
| Windows 應用程式 | 是 |
| 類別庫 | 是 |
| 主控台應用程式 | 是 |
| Windows 控制項程式庫 | 是 |
| Web 控制項程式庫 | 是 |
| Windows 服務 | 是 |
| 網站 | 是 |