roleManager 的 providers 項目 (ASP.NET 設定結構描述)
為角色管理定義角色提供者的集合。
<providers>
<add />
<clear/>
<remove />
</providers>
屬性和項目
下列小節描述本小節所述的屬性、子項目和父項目。
屬性
無。
子項目
項目 |
描述 |
|---|---|
add |
選擇性項目。 將角色提供者執行個體加入至角色管理提供者的集合。 |
clear |
選擇性項目。 移除繼承角色管理提供者的所有參考，只保留目前的 add 項目所加入的參考。 |
remove |
選擇性項目。 移除角色管理提供者集合中繼承提供者的參考。 |
父項目
項目 |
描述 |
|---|---|
configuration |
Common Language Runtime 和 .NET Framework 應用程式所使用之每一個組態檔中的必要根項目。 |
system.web |
指定 ASP.NET 組態區段的根項目。 |
roleManager |
設定角色管理的應用程式。 |
備註
providers 項目會為角色管理定義角色提供者的集合。
如需存取和修改應用程式程式碼中 roleManager 項目組態值的詳細資訊，請參閱 RoleManagerSection 類別和下列角色提供者：WindowsTokenRoleProvider、SqlRoleProvider。
預設組態
下列預設 element 項目會在電腦組態檔中設定。
<roleManager>
<providers>
<add name="AspNetSqlRoleProvider" connectionStringName="LocalSqlServer" applicationName="/" type="System.Web.Security.SqlRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
<add name="AspNetWindowsTokenRoleProvider" applicationName="/" type="System.Web.Security.WindowsTokenRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
</providers>
</roleManager>
範例
下列範例顯示 ASP.NET 應用程式，該應用程式設定為使用 SqlRoleProvider 類別儲存和擷取角色資訊。
<configuration>
<system.web>
<roleManager defaultProvider="SqlProvider"
enabled="true"
cacheRolesInCookie="true"
cookieName=".ASPROLES"
cookieTimeout="30"
cookiePath="/"
cookieRequireSSL="false"
cookieSlidingExpiration="true"
cookieProtection="All" >
<providers>
<add
name="SqlProvider"
type="System.Web.Security.SqlRoleProvider"
connectionStringName="SqlServices"
applicationName="SampleApplication" />
</providers>
</roleManager>
</system.web>
</configuration>
項目資訊
組態區段處理常式 |
|
組態成員 |
|
可設定的位置 |
Machine.config 根層次 Web.config 應用程式層級 Web.config |
需求 |
IIS 5.0、IIS 5.1 或 IIS 6.0 .NET Framework 2.0 Visual Studio 2003 或 Visual Studio 2005 |
請參閱
工作
How to: Configure Specific Folders Using Location Settings
How to: Lock ASP.NET Configuration Settings
參考
roleManager 項目 (ASP.NET 設定結構描述)
roleManager 提供者的 add 項目 (ASP.NET 設定結構描述)
roleManager 提供者的 clear 項目 (ASP.NET 設定結構描述)
roleManager 提供者的 remove 項目 (ASP.NET 設定結構描述)
system.web 項目 (ASP.NET 設定結構描述)
概念
Understanding ASP.NET Role Management