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)
判斷目前的使用者是否屬於指定的角色。
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 服務 | 是 |
網站 | 是 |