roleManager の providers の clear 要素 (ASP.NET 設定スキーマ)
更新 : 2007 年 11 月
継承したロール プロバイダへのすべての参照を削除し、現在の add 要素によって追加されたロール プロバイダだけを有効にします。
この要素は、.NET Framework Version 2.0 で追加されました。
configuration 要素 (全般設定スキーマ)
system.web 要素 (ASP.NET 設定スキーマ)
roleManager 要素 (ASP.NET 設定スキーマ)
roleManager の providers 要素 (ASP.NET 設定スキーマ)
roleManager の providers の clear 要素 (ASP.NET 設定スキーマ)
<clear/>
属性と要素
以降のセクションでは、属性、子要素、および親要素について説明します。
属性
なし。
子要素
なし。
親要素
要素 |
説明 |
|---|---|
configuration |
共通言語ランタイムおよび .NET Framework ベースのアプリケーションで使用されるすべての構成ファイルで必要なルート要素です。 |
system.web |
ASP.NET 構成セクションのルート要素を指定します。 |
roleManager |
ロール管理用のアプリケーションを構成します。 |
providers |
ロール管理に使用するロール プロバイダのコレクションを定義します。 |
解説
clear 要素は、providers 要素に格納された、継承したロール管理プロバイダへのすべての参照を削除して、その後の add 要素によって追加されたロール管理プロバイダだけを使用できるようにします。
providers 要素は、ロール管理に使用するロール プロバイダのコレクションを定義します。
アプリケーション コード内の roleManager 要素の構成値のアクセスおよび変更方法については、RoleManagerSection を参照してください。
使用例
ロール情報の格納と取得に SqlRoleProvider を使用する ASP.NET アプリケーションを構成する方法を次のコード例に示します。<clear> 要素は、SqlRoleProvider を追加する前に RoleProviderCollection コレクションを削除します。
<configuration>
<system.web>
<roleManager defaultProvider="SqlProvider"
enabled="true"
cacheRolesInCookie="true"
cookieName=".ASPROLES"
cookieTimeout="30"
cookiePath="/"
cookieRequireSSL="false"
cookieSlidingExpiration="true"
cookieProtection="All" >
<providers>
<clear />
<add
name="SqlProvider"
type="System.Web.Security.SqlRoleProvider"
connectionStringName="SqlServices"
applicationName="SampleApplication" />
</providers>
</roleManager>
</system.web>
</configuration>
要素情報
構成セクション ハンドラ |
|
構成メンバ |
|
構成できる場所 |
Machine.config ルート レベルの Web.config アプリケーション レベルの Web.config |
必要条件 |
Microsoft Internet Information Services (IIS) バージョン 5.0、5.1、または 6.0 .NET Framework Version 2.0 Microsoft Visual Studio 2003 または Visual Studio 2005 |
参照
処理手順
方法 : Location の設定を使用して特定のディレクトリを構成する
概念
参照
roleManager の providers 要素 (ASP.NET 設定スキーマ)
roleManager の providers の add 要素 (ASP.NET 設定スキーマ)
roleManager の providers の remove 要素 (ASP.NET 設定スキーマ)
roleManager 要素 (ASP.NET 設定スキーマ)
system.web 要素 (ASP.NET 設定スキーマ)