Navigation: ABC Library Reference > RelationManager > RelationManager Methods >====== RelationManager Functional Organization–Expected Use ====== | |
As an aid to understanding the RelationManager, it is useful to organize its methods into two categories according to their expected use–the primary interface and the virtual methods. This organization reflects what we believe is typical use of the RelationManager methods.
Non-Virtual Methods
The Non-Virtual Methods, which you are likely to call fairly routinely from your program, can be further divided into three categories:
Housekeeping (one-time) Use:
Init | initialize the RelationManager object | |
AddRelation | set a file relationship | |
AddRelationLink | set linking fields for a relationship | |
SetAlias | add/set a file alias | |
Kill | shut down the RelationManager object |
Mainstream Use:
Open (v) | open a file and any related files | |
Save (v) | copy current and designated related records | |
Update (v) | update current record subject to RI constraints | |
Delete (v) | delete current record subject to RI constraints | |
Close (v) | close a file and any related files |
(v)These methods are also Virtual.
Occasional Use:
ListLinkingFields | map pairs of linked fields | |
SetQuickScan | enable QuickScan across related files |
Virtual Methods
We anticipate you will often want to override these methods, and because they are virtual, they are very easy to override. These methods do provide reasonable default behavior in case you do not want to override them.
Open | open a file and any related files | |
CancelAutoInc | undo PrimeAutoInc actions | |
Save | copy current and designated related records | |
Update | update current record subject to RI constraints | |
Delete | delete current record subject to RI constraints | |
Close | close a file and any related files |