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 類別和下列角色提供者:WindowsTokenRoleProviderSqlRoleProvider

預設組態

下列預設 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>

項目資訊

組態區段處理常式

RoleManagerSection

組態成員

Providers

可設定的位置

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:使用位置設定來設定特定的目錄

HOW TO:鎖定 ASP.NET 組態設定

參考

roleManager 項目 (ASP.NET 設定結構描述)

roleManager 提供者的 add 項目 (ASP.NET 設定結構描述)

roleManager 提供者的 clear 項目 (ASP.NET 設定結構描述)

roleManager 提供者的 remove 項目 (ASP.NET 設定結構描述)

system.web 項目 (ASP.NET 設定結構描述)

configuration 項目 (一般設定結構描述)

System.Configuration

System.Web.Configuration

RoleManagerSection

RoleManager

概念

認識角色管理

保護 ASP.NET 組態

ASP.NET 組態案例

其他資源

一般組態設定 (ASP.NET)

ASP.NET 組態設定

ASP.NET 參考

ASP.NET 網站管理

ASP.NET 組態 API