roleManager の providers 要素 (ASP.NET 設定スキーマ)
ロール管理に使用するロール プロバイダーのコレクションを定義します。
<providers>
<add />
<clear/>
<remove />
</providers>
属性および要素
以降のセクションでは、このセクションに示す属性、子要素、および親要素について説明します。
属性
なし。
子要素
要素 |
説明 |
|---|---|
add |
省略可能な要素です。 ロール プロバイダーのインスタンスを、ロール管理プロバイダーのコレクションに追加します。 |
clear |
省略可能な要素です。 継承したロール管理プロバイダーへのすべての参照を削除し、現在の add 要素によって追加されたロール管理プロバイダーだけを使用できるようにします。 |
remove |
省略可能な要素です。 ロール管理プロバイダーのコレクションから、継承したプロバイダーへの参照を削除します。 |
親要素
要素 |
説明 |
|---|---|
configuration |
共通言語ランタイムおよび .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>
使用例
ロール情報の格納と取得に SqlRoleProvider クラスを使用するように構成された ASP.NET アプリケーションの例を次に示します。
<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 |
参照
処理手順
方法 : Location の設定を使用して特定のディレクトリを構成する
参照
roleManager 要素 (ASP.NET 設定スキーマ)
roleManager の providers の add 要素 (ASP.NET 設定スキーマ)
roleManager の providers の clear 要素 (ASP.NET 設定スキーマ)
roleManager の providers の remove 要素 (ASP.NET 設定スキーマ)
system.web 要素 (ASP.NET 設定スキーマ)