Share via

User.IsInRole 方法

  • 參考

定義

命名空間:
Microsoft.VisualBasic.ApplicationServices
組件:
Microsoft.VisualBasic.dll
組件:
Microsoft.VisualBasic.Forms.dll

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

多載

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 角色。

傳回

Boolean

如果目前使用者是指定角色的成員則為 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

用來檢查成員資格的角色名稱。

傳回

Boolean

如果目前使用者是指定角色的成員則為 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 服務 是
網站 是

另請參閱

適用於