RoleProvider クラス

リファレンス

定義

名前空間:: System.Web.Security

アセンブリ:: System.Web.dll

アセンブリ:: System.Web.ApplicationServices.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

public ref class RoleProvider abstract : System::Configuration::Provider::ProviderBase

public abstract class RoleProvider : System.Configuration.Provider.ProviderBase

type RoleProvider = class
    inherit ProviderBase

Public MustInherit Class RoleProvider
Inherits ProviderBase

継承: Object

ProviderBase
RoleProvider

派生: System.Web.ClientServices.Providers.ClientRoleProvider

System.Web.Security.AuthorizationStoreRoleProvider

System.Web.Security.SqlRoleProvider

System.Web.Security.WindowsTokenRoleProvider

注釈

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

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

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

.NET Framework に含まれるロールプロバイダー (FoxPro データベース、Oracle データベース、その他のデータソースなど) でサポートされていないデータソースにロール情報を格納する必要があります。
.NET Framework に付属するプロバイダーによって使用されるデータベーススキーマとは異なるデータベーススキーマを使用して、ロール情報を管理する必要があります。この一般的な例としては、企業または Web サイトの SQL Server データベースに既に存在するロールデータがあります。

コンストラクター

RoleProvider()

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

プロパティ

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

メソッド

AddUsersToRoles(String[], String[])	指定したユーザー名を、構成された `applicationName` の指定したロールに追加します。
CreateRole(String)	構成された `applicationName` のデータソースに新しいロールを追加します。
DeleteRole(String, Boolean)	構成された `applicationName` のデータソースからロールを削除します。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
FindUsersInRole(String, String)	指定したユーザー名と一致するユーザー名が含まれる、特定のロールのユーザー名の配列を取得します。
GetAllRoles()	構成されている `applicationName` のすべてのロールのリストを取得します。
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetRolesForUser(String)	構成済みの `applicationName` で指定されたユーザーに割り当てられたロールの一覧を取得します。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
GetUsersInRole(String)	構成済み `applicationName` の指定されたロールに属するユーザーのリストを取得します。
Initialize(String, NameValueCollection)	構成ビルダーを初期化します。 (継承元 ProviderBase)
IsUserInRole(String, String)	指定したユーザーが、構成された `applicationName` の指定したロールに存在するかどうかを示す値を取得します。
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
RemoveUsersFromRoles(String[], String[])	指定したユーザー名を、構成された `applicationName` の指定したロールから削除します。
RoleExists(String)	構成された `applicationName` の指定されたロール名がロールデータソースに既に存在するかどうかを示す値を取得します。
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

適用対象

こちらもご覧ください

ロールプロバイダの実装

次の方法で共有