User.IsInRole 方法

定義

命名空間:

Microsoft.VisualBasic.ApplicationServices

組件:

Microsoft.VisualBasic.Forms.dll

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

多載

IsInRole(String)

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

IsInRole(String)

來源:

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

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

傳回

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

另請參閱

• BuiltInRole
• 物件 (Visual Basic)