ObjectVersionCheckerIsEntityUpgradable Method |
Checks whether entities of the specified class can be upgraded, and helps distinguish between
backward and forward compatibility issues.
Namespace: Autodesk.CivilAssembly: AeccDrainageDesignMgd (in AeccDrainageDesignMgd.dll) Version: 13.9.960.0
Syntaxpublic static bool IsEntityUpgradable(
Database database,
RXClass rxClass
)
Public Shared Function IsEntityUpgradable (
database As Database,
rxClass As RXClass
) As Boolean
public:
static bool IsEntityUpgradable(
Database^ database,
RXClass^ rxClass
)
Parameters
- database Database
- The database containing the entities to check for upgrade capability.
- rxClass RXClass
- The runtime class of the entity type to check.
Return Value
Boolean
True if entities of the specified class can be upgraded; otherwise, false.
Returns true for backward compatibility scenarios where older version data can be upgraded.
Returns false for forward compatibility scenarios where the data is from a newer version.
When compatibility issues occur (E.g, "write/read/create" operations fail),
use this method to determine the type of compatibility issue :
True is indicating a backward compatibility issue - older version data that can be upgraded to benefit from new features / full capability in the current Civil 3D version.
False is indicating a forward compatibility issue - newer version data is being processed by the current older Civil 3D version.
Exceptions
Remarks
This method is particularly useful for determining appropriate user messaging and available actions:
- Backward compatibility: Users can upgrade objects to unlock full functionality, E.g, some UI may be read-only until upgrade
- Forward compatibility: Users might need to consider using a newer Civil 3D version to work with these objects, otherwise, user operations on these objects might be limited.
See Also