Home > Language Reference > Classes > StreamRecord

Dirty Property

Indicates whether the record has been modified since the last HotSync^® operation or not.

Syntax

Public Property Get Dirty() As Boolean
Public Property Let Dirty(ByVal bDirty As Boolean)

Remarks

Setting the Dirty property to True tells the system that this record has been modified since the last HotSync^® operation, and that it should be synchronized. Conversely, after a given database has been synchronized, all its records automatically have their Dirty property reset to False.

When a record is created using the NewRecord method of the RecordDB object, this property is automatically set, so that this record will be synchronized on the next HotSync^® operation. On the other hand, it is up to the programmer to set this attribute when modifying an existing record. For example:

Dim rec As StreamRecord
Dim db As RecordDB
Dim ndx As Long

' Here goes some code that initialize
' the db and ndx variables

Set rec = db.Record(ndx)

' Here goes some code that uses Read/Write to 
' modify the record content

rec.Dirty = True
Set db.Record(ndx) = rec

Note: When installing a database on the Palm OS^® Emulator or Simulator by clicking the 'Install Application/Database' menu item, all the records have their Dirty properties automatically set to True.

System requirements