WindowsTokenRoleProvider 類別

定義

命名空間:

System.Web.Security

組件:

System.Web.dll

從 Windows 群組成員資格取得 ASP.NET 應用程式的角色資訊。

public ref class WindowsTokenRoleProvider : System::Web::Security::RoleProvider

public class WindowsTokenRoleProvider : System.Web.Security.RoleProvider

type WindowsTokenRoleProvider = class
    inherit RoleProvider

Public Class WindowsTokenRoleProvider
Inherits RoleProvider

繼承

Object

ProviderBase

RoleProvider

WindowsTokenRoleProvider

範例

下列範例顯示 ASP.NET 應用程式的 Web.config 檔案。 它會指定應用程式同時使用 Windows 驗證和 WindowsTokenRoleProvider 類別來擷取 Windows 使用者的角色資訊。 元素 authorization 指定只有 BUILTIN\Administrators 群組中的使用者才能存取應用程式。

<configuration>
  <system.web>
    <authentication mode="Windows" />

    <authorization>
      <allow roles="BUILTIN\Administrators" />
      <deny users="*" />
    </authorization>

    <roleManager defaultProvider="WindowsProvider"
      enabled="true"
      cacheRolesInCookie="false">
      <providers>
        <add
          name="WindowsProvider"
          type="System.Web.Security.WindowsTokenRoleProvider" />
      </providers>
    </roleManager>

  </system.web>
</configuration>

備註

類別 WindowsTokenRoleProvider 是只讀角色成員資格提供者，可根據 Windows 安全組擷取 Windows 使用者的角色資訊。 在 IIS 驗證設定停用匿名驗證的情況下，使用 Windows 驗證模式的 ASP.NET 應用程式最有用。 您可以設定 ASP.NET 應用程式，根據特定 Windows 群組中的使用者成員資格來允許或拒絕存取。

您無法使用 WindowsTokenRoleProvider 類別來建立或刪除角色，或修改以 Windows 群組成員資格為基礎的角色成員資格。 這項功能是由 Windows 作業系統所管理。 類別WindowsTokenRoleProvider僅IsUserInRole支援抽象類的 RoleProvider 和 GetRolesForUser 方法。

建構函式

WindowsTokenRoleProvider()

建立 WindowsTokenRoleProvider 類別的執行個體。

屬性

ApplicationName	取得或設定應用程式的名稱。
Description	取得簡短、易讀的描述，適合顯示在管理工具或其他使用者介面 (UI) 中。 (繼承來源 ProviderBase)
Name	取得用來在設定期間代表提供者的易記名稱。 (繼承來源 ProviderBase)

方法

AddUsersToRoles(String[], String[])	Windows 語彙基元角色提供者不支援此方法。
CreateRole(String)	Windows 語彙基元角色提供者不支援此方法。
DeleteRole(String, Boolean)	Windows 語彙基元角色提供者不支援此方法。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
FindUsersInRole(String, String)	Windows 語彙基元角色提供者不支援此方法。
GetAllRoles()	Windows 語彙基元角色提供者不支援此方法。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetRolesForUser(String)	取得使用者所屬的 Windows 群組清單。
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
GetUsersInRole(String)	Windows 語彙基元角色提供者不支援此方法。
Initialize(String, NameValueCollection)	使用 ASP.NET 應用程式組態檔中指定的屬性值，初始化 Windows 語彙基元角色提供者。 這個方法不能從程式碼直接使用。
IsUserInRole(String, String)	取得值，指出指定之使用者是否在指定的 Windows 群組中。
IsUserInRole(String, WindowsBuiltInRole)	取得值，指出指定之使用者是否在指定的內建 Windows 角色中。
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
RemoveUsersFromRoles(String[], String[])	Windows 語彙基元角色提供者不支援此方法。
RoleExists(String)	Windows 語彙基元角色提供者不支援此方法。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• 瞭解角色管理 ASP.NET