ProfileModule.ProfileAutoSaving イベント

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

ProfileModule.ProfileAutoSaving イベント

メモ : このイベントは、.NET Framework version 2.0 で新しく追加されたものです。

プロファイルの自動保存が有効になっている場合、ページ実行の終了時に発生します。

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

Visual Basic (宣言)

Public Event ProfileAutoSaving As
 ProfileAutoSaveEventHandler

Visual Basic (使用法)

Dim instance As ProfileModule
Dim handler As ProfileAutoSaveEventHandler

AddHandler instance.ProfileAutoSaving, handler

C#

public event ProfileAutoSaveEventHandler ProfileAutoSaving

C++

public:
event ProfileAutoSaveEventHandler^ ProfileAutoSaving {
    void add (ProfileAutoSaveEventHandler^ value);
    void remove (ProfileAutoSaveEventHandler^ value);
}

J#

/** @event */
public void add_ProfileAutoSaving (ProfileAutoSaveEventHandler
 value)

/** @event */
public void remove_ProfileAutoSaving (ProfileAutoSaveEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

ProfileAutoSaving イベントは、ProfileManager.AutomaticSaveEnabled プロパティが true の場合、ページ実行の終了時に発生します。ASP.NET アプリケーションの Global.asax ファイルの ProfileModule クラスの ProfileAutoSaving イベントには、Profile_ProfileAutoSaving グローバル イベントを使用して、このトピックの例に示されている方法によってアクセスできます。

SettingsBase.Save メソッドは、プリミティブ型、文字列、または DateTime オブジェクトで構成されたプロパティ値が変更されたかどうかを、ユーザー プロファイル内の各 SettingsPropertyValue の IsDirty プロパティ値でチェックします。Save メソッドは、カスタム クラスが変更されたかどうかを明示的に判断することはできません。カスタム オブジェクトが変更されたかどうかは、ProfileAutoSaving イベントを使用して判断できます。その上で、変更されたオブジェクトに対しては自動保存を続行し、オブジェクトが変更されていない場合は自動保存をキャンセルできます。

プロファイルの自動保存処理をキャンセルする場合は、ProfileAutoSaving イベント内の ContinueWithProfileAutoSave プロパティを false に設定します。それ以外の場合は、ContinueWithProfileAutoSave プロパティを true に設定します。

ProfileAutoSaving イベントに対しては複数のサブスクライバが存在する場合があります。ProfileModule は、ContinueWithProfileAutoSave プロパティに最後に設定された値を使用します。したがって、ProfileAutoSaving イベント内では、自動保存をキャンセルするか続行するかにかかわらず ContinueWithProfileAutoSave プロパティを明示的に設定して、以前のサブスクライバの設定した値が上書きされるようにすることをお勧めします。

使用例

ASP.NET アプリケーションの Global.asax ファイルに含まれる ProfileAutoSaving イベントを次のコード例に示します。

Visual Basic

Public Sub Profile_ProfileAutoSaving(sender
 As Object, args As ProfileAutoSaveEventArgs)
  If Profile.Cart.HasChanged Then
    args.ContinueWithProfileAutoSave = True
  Else
    args.ContinueWithProfileAutoSave = False
  End If
End Sub

C#

public void Profile_ProfileAutoSaving(object
 sender, ProfileAutoSaveEventArgs args)
{
  if (Profile.Cart.HasChanged)
    args.ContinueWithProfileAutoSave = true;
  else
    args.ContinueWithProfileAutoSave = false;
}

プラットフォーム

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 プロファイル プロパティ