My.User.IsInRole 方法

發行項
08/21/2008

更新：2007 年 11 月

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

' Usage
Dim value As Boolean = My.User.IsInRole(role)
Dim value As Boolean = My.User.IsInRole(role)
' Declaration
Public Function IsInRole( _
   ByVal role As String _
) As Boolean
' -or-
Public Function IsInRole( _
   ByVal role As BuiltInRole _
) As Boolean

參數

role
String 或 BuiltInRole 列舉型別。要檢查成員資格的角色。

傳回值

如果目前使用者是指定之角色的成員則為 True，否則為 False。

備註

My.User.IsInRole 方法可以讓程式碼判斷目前使用者是否為指定之角色的成員。

My.User.IsInRole 方法之採用字串的多載提供簡易的存取方式，存取目前主體的 IsInRole 方法。

My.User.IsInRole 方法之採用 BuiltInRole 列舉型別的多載，它的作用方式會因目前主體而異。如果是 Windows 使用者主體 (WindowsPrincipal)，則這個函式會將 role 轉換成對等的 WindowsBuiltInRole 列舉型別，並傳回呼叫 IsInRole 的結果。如果目前主體是其他主體，則這個函式會將 role 中之列舉值的名稱，傳到該主體的 IsInRole 方法。

注意事項：
My.User 物件的實際行為要視應用程式的類型和執行應用程式的作業系統而定。如需詳細資訊，請參閱 My.User 物件。

工作

若要	請參閱
判斷使用者的角色	HOW TO：判斷使用者是否屬於某一群組

範例

這個範例會在存取資源之前，檢查使用者是否為系統管理員。

If My.User.IsInRole( _
        ApplicationServices.BuiltInRole.Administrator) Then
    ' Insert code to access a resource here.
End If

需求

命名空間：Microsoft.VisualBasic.ApplicationServices

類別：User，WebUser

組件：Visual Basic 執行階段程式庫 (在 Microsoft.VisualBasic.dll 中)

依專案類型的可用性

專案類型	是否可用
Windows 應用程式	可以
類別庫	可以
主控台應用程式	可以
Windows 控制項程式庫	可以
Web 控制項程式庫	可以
Windows 服務	可以
網站	可以