Share via


IsDirty Property

IsDirty Property

The IsDirty property specifies whether the local data has been altered since the last time it was saved to the currently bound data source.

Syntax

Property IsDirty as Boolean
HRESULT get_IsDirty(VARIANT_BOOL* pVal);
HRESULT put_IsDirty(VARIANT_BOOL Val);

Remarks

After you bind to a data source object, two copies of the data exist: the local data, and the data in the data source object. When changes are made to the local copy of the data, this flag switches to True (VARIANT_TRUE), which indicates that the local copy is dirty when it is 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. The flag is also reset whenever the object is re-bound using the methods IDataSource.OpenObject and IDataSource.SaveToObject.

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

See Also

Concepts

Save Method
OpenObject Method
SaveToObject Method