共用方式為


User.IsInRole 方法

定義

判斷目前的使用者是否屬於指定的角色。

多載

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 服務
網站

另請參閱

適用於