ProfileBase.IsDirty プロパティ

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

ProfileBase.IsDirty プロパティ

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

いずれかのプロファイル プロパティが変更されているかどうかを示す値を取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 IsDirty As Boolean

Visual Basic (使用法)

Dim instance As ProfileBase
Dim value As Boolean

value = instance.IsDirty

C#

public bool IsDirty { get;
 }

C++

public:
property bool IsDirty {
    bool get ();
}

J#

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

JScript

public function get IsDirty
 () : boolean

プロパティ値
プロファイル プロパティが変更された場合は true。それ以外の場合は false。

解説

IsDirty プロパティは、プリミティブ型、文字列、または DateTime オブジェクトで構成されるプロパティ値が変更されているかどうかを Save メソッドで判断する際に、プロファイル プロバイダによって使用されます。変更されているプロパティは、Save メソッド内でプロファイル プロバイダによって更新されます。Save メソッドは、AutomaticSaveEnabled プロパティが true の場合、ページ実行の終了時に自動的に呼び出されます。

Save メソッドから呼び出されるプロファイル プロバイダでは、カスタム クラス型や複合型 (コレクションなど) のプロファイル プロパティが変更されたかどうかを明示的に判断することはできません。カスタム オブジェクトが変更されたかどうかは、ProfileAutoSaving イベントを使用して判断できます。その上で、変更されたオブジェクトに対しては自動保存を続行し、オブジェクトが変更されていない場合は自動保存をキャンセルできます。ProfileBase クラスの既定の動作では、カスタム型や複合型のプロパティが最初にアクセスされるとき、そのプロパティに対して IsDirty プロパティを true に設定します。

プラットフォーム

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

参照

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