roleManager の providers の clear 要素 (ASP.NET 設定スキーマ)

[アーティクル]
05/27/2012

[このドキュメントはプレビューのみを目的としており、以降のリリースで変更される可能性があります。プレースホルダーとして空白のトピックが含まれています。]

継承したロールプロバイダーへのすべての参照を削除し、現在の add 要素によって追加されたロールプロバイダーだけを有効にします。

この要素は、.NET Framework Version 2.0 で追加されました。

<clear/>

属性および要素

以降のセクションでは、属性、子要素、および親要素について説明します。

属性

なし。

子要素

なし。

親要素

要素	Description
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>

要素情報

構成セクションハンドラー	RoleManagerSection
構成メンバー	Providers
構成できる場所	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

参照

次の方法で共有

roleManager の providers の clear 要素 (ASP.NET 設定スキーマ)

属性および要素

属性

子要素

親要素

解説

使用例

要素情報

参照

処理手順

Reference

概念

その他の技術情報

その他のリソース