SqlRoleProvider クラス

定義

public ref class SqlRoleProvider : System::Web::Security::RoleProvider

public class SqlRoleProvider : System.Web.Security.RoleProvider

type SqlRoleProvider = class
    inherit RoleProvider

Public Class SqlRoleProvider
Inherits RoleProvider

継承

Object

ProviderBase

RoleProvider

SqlRoleProvider

例

次の例は、 オブジェクトと を使用するように構成された ASP.NET アプリケーションの Web.config ファイルをSqlRoleProviderSqlMembershipProvider示しています。 要素は authorization 、Administrators ロールの認証済みユーザーへのアクセスのみを許可するように構成されています。

<configuration>
  <connectionStrings>
    <add name="SqlServices" connectionString="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=aspnetdb;" />
  </connectionStrings>
  <system.web>
    <authentication mode="Forms" >
      <forms loginUrl="logincs.aspx"
      name=".ASPXFORMSAUTH" />
    </authentication>
    <authorization>
      <deny users="?" />
      <allow roles="Administrators" />
      <deny users="*" />
    </authorization>
    <membership defaultProvider="SqlProvider" userIsOnlineTimeWindow="15">
      <providers>
        <add
          name="SqlProvider"
          type="System.Web.Security.SqlMembershipProvider"
          connectionStringName="SqlServices"
          enablePasswordRetrieval="false"
          enablePasswordReset="false"
          requiresQuestionAndAnswer="false"
          passwordFormat="Hashed"
          applicationName="SampleApplication" />
      </providers>
    </membership>
    <roleManager defaultProvider="SqlProvider"
      enabled="true"
      cacheRolesInCookie="true"
      cookieName=".ASPROLES"
      cookieTimeout="30"
      cookiePath="/"
      cookieRequireSSL="true"
      cookieSlidingExpiration="true"
      cookieProtection="All" >
      <providers>
        <add
          name="SqlProvider"
          type="System.Web.Security.SqlRoleProvider"
          connectionStringName="SqlServices"
          applicationName="SampleApplication" />
      </providers>
    </roleManager>
  </system.web>
</configuration>

注釈

このクラスは、 クラスと RolePrincipal クラスによって使用されRoles、SQL Server データベースを使用して ASP.NET アプリケーションのロール管理サービスを提供します。 ロール管理を使用して、アプリケーションのさまざまなレベルの承認を指定できます。

クラスを SqlRoleProvider 使用するには、まず によって使用される SQL Server データベースを作成する SqlRoleProvider必要があります。 クラスで使用されるデータベースをSqlRoleProvider作成するには、C:\WINDOWS\Microsoft.NET\Framework\ versionNumber フォルダーにある実行可能ファイルを実行aspnet_regsql.exeし、 aspnet_regsql.exe -Arオプション (例: ) を指定-Arします。 作成されたデータベースは Aspnetdb と呼ばれます。 または、aspnet_regsql.exe を実行して GUI コンフィギュレーション モードをプルし、すべての ASP.NET 機能を構成することを選択します。

ロール プロバイダーが統合セキュリティを使用する接続文字列で構成されている場合、ASP.NET アプリケーションのプロセス アカウントには、SQL Server データベースに接続する権限が必要です。

Machine.config ファイルは、ローカル コンピューター上の SqlRoleProvider SQL Server に接続する AspNetSqlProvider という名前のインスタンスで構成されます。 プロバイダーのこのインスタンスを使用するか、ASP.NET アプリケーションの Web.config ファイルで独自のものを指定できます。 AspNetSqlProvider インスタンスを使用するには、構成で として AspNetSqlProvider を defaultProvider 指定します。

と同じデータベースとユーザー情報SqlMembershipProviderを使用するように をSqlRoleProvider構成して、単一のデータベースを認証および認可情報に使用できます。 メンバーシップとロール情報に同じデータベースを使用するには、aspnet_regsql.exe 実行可能ファイルを実行し、メンバーシップ機能をインストールします。 次に、インスタンスと SqlMembershipProvider インスタンスの両方に同じ接続文字列を構成にSqlRoleProvider指定します。 また、両方のプロバイダー インスタンスが同じ ApplicationNameで構成されていることを確認します。

こちらもご覧ください

• ロール管理 ASP.NET 理解する