次の方法で共有


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

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

ロール管理に使用するロール プロバイダーのコレクションを定義します。

<providers>
   <add />
   <clear/>
   <remove />
</providers>

属性および要素

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

属性

なし。

子要素

要素

Description

add

省略可能な要素です。

ロール プロバイダーのインスタンスを、ロール管理プロバイダーのコレクションに追加します。

clear

省略可能な要素です。

継承したロール管理プロバイダーへのすべての参照を削除し、現在の add 要素によって追加されたロール管理プロバイダーだけを使用できるようにします。

remove

省略可能な要素です。

ロール管理プロバイダーのコレクションから、継承したプロバイダーへの参照を削除します。

親要素

要素

Description

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>

要素情報

構成セクション ハンドラー

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: Configure Specific Folders Using Location Settings

How to: Lock ASP.NET Configuration Settings

Reference

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

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

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

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

system.web 要素 (ASP.NET 設定スキーマ)

configuration 要素 (全般設定スキーマ)

System.Configuration

System.Web.Configuration

RoleManagerSection

RoleManager

概念

Understanding ASP.NET Role Management

Securing Configuration

Configuration Inheritance

その他の技術情報

全般構成設定 (ASP.NET)

ASP.NET 構成設定

ASP.NET リファレンス

Configuring ASP.NET Applications

ASP.NET Configuration API