Refresh Method

See Also    Example    Applies To

Updates the objects in a collection to reflect the current database's schema.

Syntax

VOIDcollection.Refresh( VOID );

The collection placeholder is an object variable that represents a persistent collection.

Remarks

You can't use the Refresh method with collections that aren't persistent, such as Connections, Databases, Recordsets, Workspaces, or the QueryDefs collection of a Connection object.

To determine the position that the Microsoft Jet database engine uses for CdbField objects in the Fields collection of a CdbQueryDef, CdbRecordset, or CdbTableDef object, use the OrdinalPosition property of each CdbField object. Changing the OrdinalPosition property of a CdbField object may not change the order of the CdbField objects in the collection until you use the Refresh method.

Use the Refresh method in multiuser environments in which other users may change the database. You may also need to use it on any collections that are indirectly affected by changes to the database. For example, if you change a Users collection, you may need to refresh a Groups collection before using the Groups collection.

A collection is filled with objects the first time it's referred to and won't automatically reflect subsequent changes other users make. If it's likely that another user has changed a collection, use the Refresh method on the collection immediately before carrying out any task in your application that assumes the presence or absence of a particular object in the collection. This will ensure that the collection is as up-to-date as possible. On the other hand, using Refresh can unnecessarily slow performance.