RecordsetType Property

Applies To

Form.

Description

You can use the RecordsetType property to specify what kind of recordset is made available to a form. For example, if you don’t want data in bound controls to be edited when a form is in Form view or Datasheet view, you can set the RecordsetType property to Snapshot.

Note For forms, the RecordsetType property replaces the AllowUpdating property found in Microsoft Access 2.0. Microsoft Access for Windows 95 supports the AllowUpdating property for backwards compatibility only. It is recommended that you use the RecordsetType property.

Setting

The RecordsetType property uses the following settings.

Setting

Description

Visual Basic

Dynaset

(Default) You can edit bound controls based on a single table or tables with a one-to-one relationship. For controls bound to fields based on tables with a one-to-many relationship, you can’t edit data from the join field on the “one” side of the relationship unless cascade update is enabled between the tables.

0

Dynaset (Inconsistent Updates)

All tables and controls bound to their fields can be edited.

1

Snapshot

No tables or the controls bound to their fields can be edited.

2


You can set this property using the form’s property sheet, a macro, or Visual Basic.

Remarks

You can create forms based on multiple underlying tables with fields bound to controls on the forms. Depending on the RecordsetType property setting, you can limit which of these bound controls can be edited.

In addition to the editing control provided by RecordsetType, each control on a form has a Locked property that you can set to specify whether the control and its underlying data can be edited. If the Locked property is set to Yes, you can’t edit the data.

See Also

AllowAdditions Property; AllowDeletions Property; AllowEdits Property; Enabled, Locked Properties.

Example

In the following example, only if the user ID is ADMIN can records be updated. This code sample sets the RecordsetType property to Snapshot if the global variable gstrUserID value is not ADMIN.


Sub Form_Open(Cancel As Integer)
    Const conSnapshot = 2
    If gstrUserID <> "ADMIN" Then
        Forms!Employees.RecordsetType = conSnapshot
    End IfSub