ProfileAutoSaveEventArgs.ContinueWithProfileAutoSave プロパティ

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

ProfileAutoSaveEventArgs.ContinueWithProfileAutoSave プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

ProfileModule がユーザー プロファイルを自動保存するかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

Public Property ContinueWithProfileAutoSave
 As Boolean

Visual Basic (使用法)

Dim instance As ProfileAutoSaveEventArgs
Dim value As Boolean

value = instance.ContinueWithProfileAutoSave

instance.ContinueWithProfileAutoSave = value

C#

public bool ContinueWithProfileAutoSave { get;
 set; }

C++

public:
property bool ContinueWithProfileAutoSave {
    bool get ();
    void set (bool value);
}

J#

/** @property */
public boolean get_ContinueWithProfileAutoSave ()

/** @property */
public void set_ContinueWithProfileAutoSave
 (boolean value)

JScript

public function get ContinueWithProfileAutoSave
 () : boolean

public function set ContinueWithProfileAutoSave
 (value : boolean)

プロパティ値
ProfileModule がユーザー プロファイルを自動保存する場合は true。それ以外の場合は false。既定値は true です。

解説

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

参照

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