Read-write. Indicates whether a view is automatically refreshed by the currently running code when a navigation method touches an update (addition, deletion, or change) to the database that occurred after view creation or the last refresh.

Defined in

NotesView

Data type

Boolean

Syntax

To get: flag = notesView.AutoUpdate

To set: notesView.AutoUpdate = flag

Legal values

• True (default) indicates that the view is automatically refreshed.
• False indicates that the view is not automatically refreshed.

Set this property to False if you want the view to remain static during processing.

You may want to set this property to False to enhance performance. For example, you are processing all the documents in a large view and don't care about any changes that occur in the database during that processing.

If this property is False, you must call Refresh to navigate to an update.

Even if this property is True, you must call Refresh if you are not navigating to an update and you want the view refreshed, for example, to get the top level entry count.

This method does not refresh the front-end view that the interactive user sees, nor does it rebuild the front-end view. See ViewRefresh and ViewRebuild in NotesUIWorkspace.

Caution This property only addresses refreshes by the currently running code. Other code, such as running the Updall task against the database, will update the view index and NotesViewNavigator regardless of the value of this property. If it is necessary to process every document in a view, do not rely upon a view remaining static. See Collecting all documents and all unprocessed documents for a discussion of solutions to this issue.

Language cross-reference

IsAutoUpdate property in Java View class

Collecting all documents and all unprocessed documents

Example

Glossary