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

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

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

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

configuration 要素 (全般設定スキーマ)
  system.web 要素 (ASP.NET 設定スキーマ)
    roleManager 要素 (ASP.NET 設定スキーマ)
      roleManager の providers 要素 (ASP.NET 設定スキーマ)
        roleManager の providers の add 要素 (ASP.NET 設定スキーマ)

<add name="provider name" 
     type="string"
     connectionStringName="string"
     applicationName="string" 
     commandTimeout="number" 
     description="string" 
     cacheRefreshInterval="number" 
     scopeName="string"/>

属性と要素

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

属性

属性	説明
applicationName	省略可能な String 型の属性です。データソースでロール名を格納するアプリケーションの名前を指定ます。アプリケーション名を指定すると、複数の ASP.NET アプリケーションで同じデータベースを使用できます。ロール名は異なるアプリケーションごとに複製されません。また、同じアプリケーション名を指定すると、複数の ASP.NET アプリケーションで同じロール情報を使用できます。この属性を指定しない場合、.NET Framework に含まれるロールプロバイダは、ApplicationName プロパティに対して ApplicationVirtualPath 値を使用します。
cacheRefreshInterval	省略可能な Int32 型の属性です。キャッシュされたポリシーストアデータを強制的に更新する間隔を分単位で指定し、AuthorizationStoreRoleProvider にだけ適用します。既定値は 60 です。
commandTimeout	省略可能な Int32 型の属性です。ロールマネージャデータソースに対して実行されたコマンドがタイムアウトするまでの時間 (秒数)。このタイムアウト値は、SQL プロバイダが SqlCommand オブジェクトを作成するときに使用します。既定では、この属性は ASP.NET 構成では設定されていません。そのため、ADO.NET の既定値である 30 秒が使用されます。この属性が設定されると、SQL プロバイダは、データベースに対して実行されるすべての SQL コマンドについて、構成されたタイムアウト値を使用します。既定値は 30 です (ADO.NET の既定値)。
connectionStringName	必須の String 属性です。 <connectionStrings> 要素に定義されている接続文字列の名前を指定します。指定した接続文字列は、追加されるプロバイダによって使用されます。
description	省略可能な String 属性です。ロールプロバイダインスタンスの説明を入力します。
name	必須の String 属性です。プロバイダのインスタンスの名前を指定します。この値は、プロバイダインスタンスを既定のロールプロバイダとして識別するために、<roleManager> 要素の defaultProvider 属性に使用します。プロバイダの name は、Providers コレクション内のプロバイダにインデックスを付けるためにも使用します。
scopeName	省略可能な String 型の属性です。プロバイダインスタンスが接続する承認マネージャポリシーストアのセキュリティスコープを指定し、AuthorizationStoreRoleProvider にだけ適用します。scopeName が指定されている場合、プロバイダがポリシーストアに接続する際に applicationName と scopeName の組み合わせが使用されます。
type	必須の String 属性です。 RoleProvider 抽象基本クラスを実装する型を指定します。

子要素

なし。

親要素

要素	説明
configuration	共通言語ランタイムおよび .NET Framework ベースのアプリケーションで使用されるすべての構成ファイルで必要なルート要素です。
system.web	ASP.NET 構成セクションのルート要素を指定します。
roleManager	ロール管理用のアプリケーションを構成します。
providers	ロール管理に使用するロールプロバイダのコレクションを定義します。

解説

add 要素は、ロールプロバイダインスタンスを、providers 要素に格納されたロール管理プロバイダコレクションに追加します。

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

アプリケーションコード内の roleManager 要素の構成値のアクセスおよび変更方法については、RoleManagerSection、WindowsTokenRoleProvider、SqlRoleProvider、および AuthorizationStoreRoleProvider を参照してください。

既定の構成

次の既定の providers 要素は、Machine.config ファイルで構成されます。

<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
構成メンバ	Add
構成できる場所	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 の add 要素 (ASP.NET 設定スキーマ)

属性と要素

属性

子要素

親要素

解説

既定の構成

使用例

要素情報

参照

処理手順

概念

参照

その他の技術情報

その他のリソース