ProfileModule.ProfileAutoSaving イベントとは何？わかりやすく解説 Weblio辞書

.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

public event ProfileAutoSaveEventHandler ProfileAutoSaving

C++

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

/** @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

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