NewRecord Property [Access 2003 VBA Language Reference]

You can use the NewRecord property to determine whether the current record is a new record. Read-only Integer.


expression Required. An expression that returns one of the objects in the Applies To list.


The NewRecord property uses the following settings.

Setting Description
True The current record is new.
False The current record isn't new.

Note  The NewRecord property is read-only in Form view and Datasheet view. It isn't available in Design view. This property is available only by using a macro or Visual Basic .

When a user has moved to a new record, the NewRecord property setting will be True whether the user has started to edit the record or not.


The following example shows how to use the NewRecord property to determine if the current record is a new record. The NewRecordMark procedure sets the current record to the variable intnewrec. If the record is new, a message is displayed notifying the user of this. You could run this procedure when the Current event for a form occurs.

Sub NewRecordMark(frm As Form)
    Dim intnewrec As Integer

    intnewrec = frm.NewRecord
    If intnewrec = True Then
    MsgBox "You're in a new record." _
        & "@Do you want to add new data?" _
        & "@If not, move to an existing record."
    End If
End Sub

Applies to | Form Object

See Also | CurrentRecord Property