ProfileModule

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

ProfileModule イベント

パブリック イベント

	名前	説明
	MigrateAnonymous	あるプロファイルに対する匿名ユーザーがログインするときに発生します。
	Personalize	ユーザー プロファイルが作成される前に発生します。
	ProfileAutoSaving	プロファイルの自動保存が有効になっている場合、ページ実行の終了時に発生します。

参照

関連項目

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

その他の技術情報

ASP.NET プロファイル プロパティ

ProfileModule クラス

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

ユーザー プロファイルとプロファイル イベントの作成を管理します。このクラスは継承できません。

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

Visual Basic (宣言)

Public NotInheritable Class
 ProfileModule
    Implements IHttpModule

Visual Basic (使用法)

Dim instance As ProfileModule

C#

public sealed class ProfileModule : IHttpModule

C++

public ref class ProfileModule sealed : IHttpModule

J#

public final class ProfileModule implements
 IHttpModule

JScript

public final class ProfileModule implements
 IHttpModule

解説

ユーザー プロファイルが有効にされている場合、ASP.NET は ProfileModule を使用してユーザー プロファイルを作成し、これを現在の HttpContext の Profile プロパティ内に格納します。

ProfileModule は、アプリケーションで処理することにより認証を構成できる次のイベントを公開します。

• 匿名ユーザーがログインした場合にプロファイル設定を匿名プロファイルから認証済みプロファイルへ移行するための MigrateAnonymous イベント。

• ユーザー プロファイルの作成方法をカスタマイズするための Personalize イベント。

• AutomaticSaveEnabled プロパティが true に設定された場合にユーザー プロファイルの保存方法を制御するための ProfileAutoSaving イベント。

ユーザー プロファイルの有効化の詳細については、「profile 要素 (ASP.NET 設定スキーマ)」を参照してください。

使用例

匿名ユーザーをサポートする匿名の識別およびプロファイル プロパティを有効にする Web.config ファイルの例を次に示します。

<configuration>
  <system.web>
    <authentication mode="Forms" >
      <forms loginUrl="login.aspx" name=".ASPXFORMSAUTH" />
    </authentication>

    <anonymousIdentification enabled="true" />

    <profile enabled="true" defaultProvider="AspNetSqlProvider">
      <properties>
        <add name="ZipCode" allowAnonymous="true" />
        <add name="CityAndState" allowAnonymous="true" />
        <add name="StockSymbols" type="System.Collections.ArrayList" allowAnonymous="true"
 />
      </properties>
    </profile>
  </system.web>
</configuration>

ASP.NET アプリケーションの Global.asax ファイルに含まれる MigrateAnonymous イベントを次のコード例に示します。MigrateAnonymous イベントは、匿名プロファイルから現在のユーザーのプロファイルへと、プロファイル プロパティ値をコピーします。

Visual Basic

Public Sub Profile_OnMigrateAnonymous(sender
 As Object, args As ProfileMigrateEventArgs)
  Dim anonymousProfile As ProfileCommon = Profile.GetProfile(args.AnonymousID)

  Profile.ZipCode = anonymousProfile.ZipCode
  Profile.CityAndState = anonymousProfile.CityAndState
  Profile.StockSymbols = anonymousProfile.StockSymbols

  ''''''''
  ' Delete the anonymous profile. If the anonymous ID is not 
  ' needed in the rest of the site, remove the anonymous cookie.

  ProfileManager.DeleteProfile(args.AnonymousID)
  AnonymousIdentificationModule.ClearAnonymousIdentifier()
End Sub

C#

public void Profile_OnMigrateAnonymous(object
 sender, ProfileMigrateEventArgs args)
{
  ProfileCommon anonymousProfile = Profile.GetProfile(args.AnonymousID);

  Profile.ZipCode = anonymousProfile.ZipCode;
  Profile.CityAndState = anonymousProfile.CityAndState;
  Profile.StockSymbols = anonymousProfile.StockSymbols;

  ////////
  // Delete the anonymous profile. If the anonymous ID is not 
  // needed in the rest of the site, remove the anonymous cookie.

  ProfileManager.DeleteProfile(args.AnonymousID);
  AnonymousIdentificationModule.ClearAnonymousIdentifier(); 
}

.NET Framework のセキュリティ

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

継承階層

System.Object
  System.Web.Profile.ProfileModule

スレッド セーフ

この型の 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

参照

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

ProfileModule コンストラクタ

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

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

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New ProfileModule

C#

public ProfileModule ()

C++

public:
ProfileModule ()

J#

public ProfileModule ()

JScript

public function ProfileModule ()

解説

このコンストラクタは、アプリケーション コードから呼び出すためのものではありません。

HttpApplication は、ASP.NET アプリケーションの起動時に作成されます。HttpApplication は、ProfileModule コンストラクタを呼び出して、アプリケーションの ProfileModule を作成します。ProfileModule は、アプリケーションの構成で指定されます。

.NET Framework のセキュリティ

• System.Security.Permissions.SecurityPermission  アンマネージ コードから ProfileModule クラスを使用するためのアクセス許可。要求値 : Demand。アクセス許可値 : UnmanagedCode。

プラットフォーム

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

参照

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

ProfileModule メソッド

パブリック メソッド

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

	名前	説明
	Dispose	ProfileModule によって使用されているすべてのリソースを解放します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	Init	ProfileModule オブジェクトが作成されるときに、初期化コードを呼び出します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

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

参照

関連項目

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

その他の技術情報

ASP.NET プロファイル プロパティ

ProfileModule メンバ

ユーザー プロファイルとプロファイル イベントの作成を管理します。このクラスは継承できません。

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

パブリック コンストラクタ

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

パブリック メソッド

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

	名前	説明
	Dispose	ProfileModule によって使用されているすべてのリソースを解放します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	Init	ProfileModule オブジェクトが作成されるときに、初期化コードを呼び出します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

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

パブリック イベント

	名前	説明
	MigrateAnonymous	あるプロファイルに対する匿名ユーザーがログインするときに発生します。
	Personalize	ユーザー プロファイルが作成される前に発生します。
	ProfileAutoSaving	プロファイルの自動保存が有効になっている場合、ページ実行の終了時に発生します。

参照

関連項目

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

その他の技術情報

ASP.NET プロファイル プロパティ