ProfileProvider

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

ProfileProvider クラス

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

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

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

Visual Basic (宣言)

Public MustInherit Class
 ProfileProvider
    Inherits SettingsProvider

Visual Basic (使用法)

Dim instance As ProfileProvider

C#

public abstract class ProfileProvider : SettingsProvider

C++

public ref class ProfileProvider abstract :
 public SettingsProvider

J#

public abstract class ProfileProvider extends
 SettingsProvider

JScript

public abstract class ProfileProvider extends
 SettingsProvider

解説

ASP.NET のプロファイルによって、永続ストレージが提供され、ユーザー固有のプロパティを取得できます。プロファイルのプロパティ値と情報は、ProfileProvider の実装で決定された形式でデータ ソース内に格納されます。.NET Framework に含まれるプロファイル プロバイダ (ProfileProvider 抽象クラスから派生したクラスによって表される) を利用したり、 ProfileProvider から派生した新しいクラスを作成することで独自のプロバイダを実装したりできます。

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

• Oracle データベースまたは他のデータベース ストアなどの、.NET Framework で含められたプロファイル プロバイダがサポートしていないデータ ストア内に、プロファイル情報を格納する必要があるため。

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

ProfileProvider 抽象クラスは、ProviderBase 抽象クラスを継承する SettingsProvider 抽象クラスから継承されます。ProfileProvider を実装するクラスは、SettingsProvider 抽象クラスおよび ProviderBase 抽象クラスの必須メンバも実装する必要があります。プロファイル プロバイダの実装の詳細については、「プロファイル プロバイダの実装」を参照してください。

Topic	Location
プロファイル プロバイダの実装	ASP .NET Web アプリケーションの作成

使用例

ProfileProvider 実装の例については、「方法 : プロファイル プロバイダの構築と実行の例」を参照してください。

.NET Framework のセキュリティ

• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)要求値 : LinkDemand; アクセス許可値 : Minimal。
• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)要求値 : InheritanceDemand; アクセス許可値 : Minimal。

継承階層

System.Object
   System.Configuration.Provider.ProviderBase
     System.Configuration.SettingsProvider
      System.Web.Profile.ProfileProvider
         System.Web.Profile.SqlProfileProvider

スレッド セーフ

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
ProfileProvider メンバ
System.Web.Profile 名前空間
その他の技術情報
プロファイル プロバイダの実装
ASP.NET プロファイル プロパティ

ProfileProvider コンストラクタ

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

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

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

Visual Basic (宣言)

Protected Sub New

Visual Basic (使用法)

Dim instance As New ProfileProvider

C#

protected ProfileProvider ()

C++

protected:
ProfileProvider ()

J#

protected ProfileProvider ()

JScript

protected function ProfileProvider ()

解説

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
ProfileProvider クラス
ProfileProvider メンバ
System.Web.Profile 名前空間
その他の技術情報
プロファイル プロバイダの実装
ASP.NET プロファイル プロパティ

ProfileProvider プロパティ

パブリック プロパティ

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

参照

関連項目

ProfileProvider クラス
System.Web.Profile 名前空間

その他の技術情報

プロファイル プロバイダの実装
ASP.NET プロファイル プロパティ

ProfileProvider メソッド

パブリック メソッド

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

	名前	説明
	DeleteInactiveProfiles	派生クラスでオーバーライドされた場合、最後のアクティビティの日付が指定した日付以前であるプロファイルについて、すべてのユーザー プロファイル データを削除します。
	DeleteProfiles	オーバーロードされます。 データ ソースからプロファイルのプロパティと情報を削除します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	FindInactiveProfilesByUserName	派生クラスでオーバーライドされた場合、最後のアクティビティの日付が指定した日付またはそれ以前であり、指定されたユーザー名と一致するユーザー名のプロファイルに関する、プロファイル情報を取得します。
	FindProfilesByUserName	派生クラスでオーバーライドされた場合、指定されたユーザー名と一致するユーザー名のプロファイルに関するプロファイル情報を取得します。
	GetAllInactiveProfiles	派生クラスでオーバーライドされた場合、最後のアクティビティの日付が指定した日付またはそれ以前であるプロファイルについて、データ ソースからユーザー プロファイル データを取得します。
	GetAllProfiles	派生クラスでオーバーライドされた場合、データ ソース内のすべてのプロファイルに関するユーザー プロファイル データを取得します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetNumberOfInactiveProfiles	派生クラスでオーバーライドされたときに、最後のアクティビティの日付が指定した日付またはそれ以前であるプロファイルの数を返します。
	GetPropertyValues	指定したアプリケーションのインスタンスと設定プロパティ グループの、設定プロパティ値のコレクションを返します。 ( SettingsProvider から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	Initialize	プロバイダを初期化します。 ( ProviderBase から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	SetPropertyValues	指定したプロパティ設定のグループの値を設定します。 ( SettingsProvider から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

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

参照

関連項目

ProfileProvider クラス
System.Web.Profile 名前空間

その他の技術情報

プロファイル プロバイダの実装
ASP.NET プロファイル プロパティ

ProfileProvider メンバ

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

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

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

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

パブリック プロパティ

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

パブリック メソッド

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

	名前	説明
	DeleteInactiveProfiles	派生クラスでオーバーライドされた場合、最後のアクティビティの日付が指定した日付以前であるプロファイルについて、すべてのユーザー プロファイル データを削除します。
	DeleteProfiles	オーバーロードされます。 データ ソースからプロファイルのプロパティと情報を削除します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	FindInactiveProfilesByUserName	派生クラスでオーバーライドされた場合、最後のアクティビティの日付が指定した日付またはそれ以前であり、指定されたユーザー名と一致するユーザー名のプロファイルに関する、プロファイル情報を取得します。
	FindProfilesByUserName	派生クラスでオーバーライドされた場合、指定されたユーザー名と一致するユーザー名のプロファイルに関するプロファイル情報を取得します。
	GetAllInactiveProfiles	派生クラスでオーバーライドされた場合、最後のアクティビティの日付が指定した日付またはそれ以前であるプロファイルについて、データ ソースからユーザー プロファイル データを取得します。
	GetAllProfiles	派生クラスでオーバーライドされた場合、データ ソース内のすべてのプロファイルに関するユーザー プロファイル データを取得します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetNumberOfInactiveProfiles	派生クラスでオーバーライドされたときに、最後のアクティビティの日付が指定した日付またはそれ以前であるプロファイルの数を返します。
	GetPropertyValues	指定したアプリケーションのインスタンスと設定プロパティ グループの、設定プロパティ値のコレクションを返します。 (SettingsProvider から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	Initialize	プロバイダを初期化します。 (ProviderBase から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	SetPropertyValues	指定したプロパティ設定のグループの値を設定します。 (SettingsProvider から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

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

参照

関連項目

ProfileProvider クラス
System.Web.Profile 名前空間

その他の技術情報

プロファイル プロバイダの実装
ASP.NET プロファイル プロパティ