Dataset Methods

The following methods offer control over datasets which are file-based.

A file-based dataset is a file which contains graphical items. File-based datasets must be inserted or imported into an Overlay in order to see the contents.

Note: Some of the methods in this section use an nDataset& argument to refer to the serial number of a dataset. The serial number can be obtained from the Dataset property of an overlay or from the GetDataset, GetDatasetContainer or FindExternalDataset methods. The serial number cannot be relied upon to be identical in each session, or if the dataset is removed and re-added. The number returned should therefore not be stored for long-term use.


BeginDatasetTransaction  
Begins a transaction on a Dataset.
CloseDataset  
Closes a dataset.
CloseIndexDatasetTile  
Closes a named dataset tile within an index dataset.
CommitDatasetTransaction  
Commits a transaction on a Dataset.
CompactDataset  
Discards all undo actions and defragments the memory used by a dataset.
CreateIdb Creates a new idb file with a set of attribute columns.
CreateBds  
Creates an empty BDS (Base DataSet) file.
EnsureOpenWithin  
Forces datasets in the current SWD to open any items within the given extents, at the given scale.
FindExternalDataset  
Gets the serial number of a dataset that is already open.
GetDatasetContainer  
Gets the serial number of the dataset that contains the specified dataset, e.g. in an Index Dataset.
GetDatasetExtent  
Gets the extents of all of the items in a dataset.
GetDatasetPrj  
Gets a copy of a dataset coordinate reference system.
ImportDataset  
Imports a dataset into the current SWD.
ImportDataSourceOverlay  
Imports a dataset into the current SWD, that will fetch data from non-file data source.
InsertDataset  
Inserts a dataset into the current SWD.
OwnDataset  
Sets the ownership of a dataset.
RefreshDataset  
Makes sure a dataset is up-to-date.
RollbackDatasetTransaction  
Rolls back a transaction on a Dataset.
SaveDataset  
Saves a dataset if it has been modified.
SetDatasetPrj  
Sets a dataset coordinate reference system.
CreateDbTableOverlay   Creates a new Attribute Table overlay, ie a read-only view of a database table that has no geometry.