DataRecordset.RefreshSettings Property

Visio Automation Reference

Gets and sets options that determine how the data recordset is refreshed. Read/write.

Note
This Visio object or member is available only to licensed users of Microsoft Office Visio Professional 2007.

Version Information
 Version Added:  Visio 2007

Syntax

expression.RefreshSettings

expression   An expression that returns a DataRecordset object.

Return Value
Long

Remarks

Constants for how a data recordset is refreshed are declared in the VisRefreshSettings enumeration in the Visio type library:

Constant	Value	Description
visRefreshNoReconciliationUI	2	Disables the Refresh Conflicts task pane in the Visio user interface (UI) after a refresh operation.
visRefreshOverwriteAll	1	When data is refreshed, overwrites all user changes made in the shape data of shapes linked to data in this recordset since the previous refresh operation. See note.

The default is for neither of the VisRefreshSettings flags to be turned on. (RefreshSettings = 0).

When visRefreshNoReconciliationUI is set, support for reconciling refresh conflicts in the Visio UI is disabled. As a developer, you should reconcile refresh conflicts programmatically by using the GetAllRefreshConflicts, GetMatchingRowsForRefreshConflict, and RemoveRefreshConflict methods.

Note
In previous versions of Visio, shape data was called custom properties.

See Also

• DataRecordset Object
• DataRecordset Object Members