WebSecurity - RequireRoles()
❮ WebSecurity
Definition(定義)
RequireRoles() 方法在當前使用者不屬於所有指定角色時,將 HTTP 狀態設定為 401 (Unauthorized)。
C# 和 VB 語法
WebSecurity.RequireRoles(roles)
示例
C# 示例
WebSecurity.RequireRoles("Admin", "Poweruser");
VB 示例
WebSecurity.RequireRoles("Admin", "Poweruser")
引數
引數 | 型別 | 描述 |
---|---|---|
roles | 字串 | 當前使用者必須屬於的角色列表,以逗號分隔。 |
返回值
無。
錯誤和異常
如果以下任一情況發生,則對 WebSecurity 物件的任何訪問都會引發 InvalidOperationException:
- 尚未呼叫 InitializeDatabaseConnection() 方法
- SimpleMembership 未初始化(或在網站配置中停用)
備註
RequireRoles() 驗證當前使用者是否是所有指定角色的成員。如果使用者不是所有指定角色的成員,則 HTTP 狀態設定為 401 (Unauthorized)。
要驗證使用者是否已透過身份驗證,請使用 RequireAuthenticatedUser() 方法。
要驗證當前使用者是否為特定使用者,請使用 RequireUser() 方法。
❮ WebSecurity