IsDirty Property

[This is preliminary documentation and subject to change.]

Specifies whether or not the local data has been altered since the last save to the currently bound data source.

[Visual Basic,VBScript]
Property IsDirty as Boolean
[C++]
HRESULT get_IsDirty(VARIANT_BOOL* pVal);
HRESULT put_IsDirty(VARIANT_BOOL Val);
[IDL]
HRESULT [propget] IsDirty([out,retval] VARIANT_BOOL* pVal);
HRESULT [propput] IsDirty([in] VARIANT_BOOL Val);

Remarks

After binding to a data source such as an applicable object or to an item in the Web Store, there are two copies of the data: the local data, and the data at the data source. When changes are made to the local copy of the data, this flag switches to True (VARIANT_TRUE), indicating that the local copy " is dirty" when compared to the data in the data source. The IsDirty flag is reset to False (VARIANT_FALSE) whenever the local data is saved back into the bound object using IDataSource.Save. Additionally, the flag is also reset whenever the object is re-bound using the methods IDataSource.Open, IDataSource.OpenObject, IDataSource.SaveTo, IDataSource.SaveToContainer, and IDataSource.SaveToObject.

The IsDirty property does not reflect that changes have subsequently occurred to the data in a bound data source since the time it was bound.

See Also

IDataSource.Open, IDataSource.OpenObject, IDataSource.SaveTo, IDataSource.SaveToContainer, IDataSource.SaveToObject