RoleProviderとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

RoleProvider クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

カスタムロールプロバイダを使用してロール管理サービスを提供するために、ASP.NET が実装するコントラクトを定義します。

名前空間: System.Web.Security
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public MustInherit Class
 RoleProvider
    Inherits ProviderBase

Visual Basic (使用法)

Dim instance As RoleProvider

public abstract class RoleProvider : ProviderBase

C++

public ref class RoleProvider abstract : public
 ProviderBase

public abstract class RoleProvider extends
 ProviderBase

JScript

public abstract class RoleProvider extends
 ProviderBase

解説

ASP.NET ロール管理は、ASP.NET アプリケーションに対してさまざまなロールプロバイダを簡単に使用できるように設計されています。.NET Framework に用意されているロールプロバイダを使用することもできますし、独自のプロバイダを実装することもできます。

カスタムロールプロバイダを実装する場合は、RoleProvider 抽象クラスを継承する必要があります。

カスタムロールプロバイダを作成する主な理由は 2 つあります。

Oracle データベース、他のデータソースなど、.NET Framework に付属のロールプロバイダがサポートしていないデータソース内に、ロール情報を格納する必要があるため。
.NET Framework に同梱されているプロバイダが使用するデータベーススキーマとは異なるデータベーススキーマを使用してロール情報を管理する必要があるため。この代表的な例は、ロールデータが社内ネットワーク用または Web サイト用の SQL Server データベース内に存在している場合です。

Topic	Location
ロールプロバイダの実装	ASP .NET Web アプリケーションの作成
方法 : サンプルロールプロバイダを実装する	ASP .NET Web アプリケーションの作成

.NET Framework のセキュリティ

AspNetHostingPermission ホスト環境で RoleProvider クラスを継承するために必要なアクセス許可。要求値 : LinkDemand。アクセス許可値 : Minimal。

継承階層

System.Object
   System.Configuration.Provider.ProviderBase
    System.Web.Security.RoleProvider
       System.Web.Security.AuthorizationStoreRoleProvider
       System.Web.Security.SqlRoleProvider
       System.Web.Security.WindowsTokenRoleProvider

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
RoleProvider メンバ
System.Web.Security 名前空間
その他の技術情報
ロールプロバイダの実装

RoleProvider コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

RoleProvider クラスの新しいインスタンスを初期化します。

名前空間: System.Web.Security
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Protected Sub New

Visual Basic (使用法)

Dim instance As New RoleProvider

protected RoleProvider ()

C++

protected:
RoleProvider ()

protected RoleProvider ()

JScript

protected function RoleProvider ()

解説

RoleProvider 抽象クラスを継承するクラスでは、コンストラクタを実装する必要はありません。RoleProvider 実装の初期化値は、Initialize メソッド実装に渡されます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
RoleProvider クラス
RoleProvider メンバ
System.Web.Security 名前空間
その他の技術情報
ロールプロバイダの実装

RoleProvider プロパティ

パブリックプロパティパブリックプロパティ

	名前	説明
	ApplicationName	ロール情報を保管および取得するアプリケーションの名前を取得または設定します。
	Description	管理ツールまたは他のユーザーインターフェイス (UI) での表示に適した、簡単でわかりやすい説明を取得します。 ( ProviderBase から継承されます。)
	Name	構成時にプロバイダを参照するために使用される表示名を取得します。 ( ProviderBase から継承されます。)

参照

その他の技術情報

ロールプロバイダの実装

RoleProvider メソッド

パブリックメソッドパブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	AddUsersToRoles	指定されたユーザー名を、構成済みの applicationName の指定されたロールに追加します。
	CreateRole	新しいロールを構成済みの applicationName のデータソースに追加します。
	DeleteRole	構成済みの applicationName のデータソースからロールを削除します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	FindUsersInRole	指定されたロールで、ユーザー名が指定内容と一致するユーザーの配列を取得します。
	GetAllRoles	構成済みの applicationName のすべてのロールのリストを取得します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetRolesForUser	構成済みの applicationName で指定されたユーザーに割り当てられたロールのリストを取得します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	GetUsersInRole	構成済みの applicationName の指定されたロールに属するユーザーのリストを取得します。
	Initialize	プロバイダを初期化します。 ( ProviderBase から継承されます。)
	IsUserInRole	指定されたユーザーが、構成済みの applicationName の指定されたロールに存在するかどうかを示す値を取得します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	RemoveUsersFromRoles	指定したユーザー名を構成済みの applicationName の指定したロールから削除します。
	RoleExists	指定されたロール名が、構成済みの applicationName のロールデータソースに既に存在するかどうかを示す値を取得します。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

その他の技術情報

ロールプロバイダの実装

RoleProvider メンバ

カスタムロールプロバイダを使用してロール管理サービスを提供するために、ASP.NET が実装するコントラクトを定義します。

RoleProvider データ型で公開されるメンバを以下の表に示します。

プロテクトコンストラクタ

	名前	説明
	RoleProvider	RoleProvider クラスの新しいインスタンスを初期化します。

パブリックプロパティ

	名前	説明
	ApplicationName	ロール情報を保管および取得するアプリケーションの名前を取得または設定します。
	Description	管理ツールまたは他のユーザーインターフェイス (UI) での表示に適した、簡単でわかりやすい説明を取得します。(ProviderBase から継承されます。)
	Name	構成時にプロバイダを参照するために使用される表示名を取得します。(ProviderBase から継承されます。)

パブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	AddUsersToRoles	指定されたユーザー名を、構成済みの applicationName の指定されたロールに追加します。
	CreateRole	新しいロールを構成済みの applicationName のデータソースに追加します。
	DeleteRole	構成済みの applicationName のデータソースからロールを削除します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	FindUsersInRole	指定されたロールで、ユーザー名が指定内容と一致するユーザーの配列を取得します。
	GetAllRoles	構成済みの applicationName のすべてのロールのリストを取得します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetRolesForUser	構成済みの applicationName で指定されたユーザーに割り当てられたロールのリストを取得します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	GetUsersInRole	構成済みの applicationName の指定されたロールに属するユーザーのリストを取得します。
	Initialize	プロバイダを初期化します。 (ProviderBase から継承されます。)
	IsUserInRole	指定されたユーザーが、構成済みの applicationName の指定されたロールに存在するかどうかを示す値を取得します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	RemoveUsersFromRoles	指定したユーザー名を構成済みの applicationName の指定したロールから削除します。
	RoleExists	指定されたロール名が、構成済みの applicationName のロールデータソースに既に存在するかどうかを示す値を取得します。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)