DBObject Class

Description

This .NET class wraps the AcDbObject ObjectARX class.

The DBObject class is the base class for all objects that reside in an Database object. This class provides all the functionality for database residency such as objectId, handle, ownership, filing, persistent reactor notification, xdata, deepClone, object state queries, erase, audit, etc. Many of these involve virtual functions so that they can be overridden in classes derived from Object.

Opening Objects

Objects can be opened in one of three modes:

Value Meaning
OpenMode.ForRead Up to 256 readers can be opened at once, as long as object is not already open kForWrite or kForNotify. Member functions invoked when an object is opened kForRead should not cause object to be modified.
OpenMode.ForWrite Can be opened for write if it is not open at all, otherwise an open kForWrite fails. Member functions invoked when an object is opened kForWrite may or may not modify the object.
OpenMode.ForNotify Can be opened for notification whenever it is closed, open for read (any number) or open for write, but not when it is already open for notify. Member functions allowed to be invoked when open in this mode should not interfere with any current readers or writers, although they may cause the object to alter itself.

ForNotify is intended to be the most powerful open function, and the most transient. Opening in ForNotify mode can only fail if a previous user has left it open in this mode. When open in this mode, any subsequent open requests fail, even ForNotify. Therefore, this mode should be used sparingly, and objects opened in this mode should be sent the proper member function call or calls and closed as soon as possible.

Because of the restrictions on multiple opening of objects, never leave objects open any longer than necessary and always try to open in the least restrictive mode necessary.

Class Hierarchy

Autodesk.AutoCAD.DatabaseServices.DBObject
    Autodesk.AutoCAD.DatabaseServices.AssocAction
    Autodesk.AutoCAD.DatabaseServices.AssocActionBody
    Autodesk.AutoCAD.DatabaseServices.AssocActionParam
    Autodesk.AutoCAD.DatabaseServices.AssocDependency
    Autodesk.AutoCAD.DatabaseServices.AssocDependencyBody
    Autodesk.AutoCAD.DatabaseServices.AssocManager
    Autodesk.AutoCAD.DatabaseServices.Background
    Autodesk.AutoCAD.DatabaseServices.DataLink
    Autodesk.AutoCAD.DatabaseServices.DataTable
    Autodesk.AutoCAD.DatabaseServices.DBDictionary
    Autodesk.AutoCAD.DatabaseServices.DBVisualStyle
    Autodesk.AutoCAD.DatabaseServices.DetailViewStyle
    Autodesk.AutoCAD.DatabaseServices.DrawOrderTable
    Autodesk.AutoCAD.DatabaseServices.Entity
    Autodesk.AutoCAD.DatabaseServices.Field
    Autodesk.AutoCAD.DatabaseServices.Filters.Filter
    Autodesk.AutoCAD.DatabaseServices.Filters.Index
    Autodesk.AutoCAD.DatabaseServices.GeoLocationData
    Autodesk.AutoCAD.DatabaseServices.Group
    Autodesk.AutoCAD.DatabaseServices.LinkedData
    Autodesk.AutoCAD.DatabaseServices.LongTransaction
    Autodesk.AutoCAD.DatabaseServices.Material
    Autodesk.AutoCAD.DatabaseServices.MLeaderStyle
    Autodesk.AutoCAD.DatabaseServices.MlineStyle
    Autodesk.AutoCAD.DatabaseServices.PlaceHolder
    Autodesk.AutoCAD.DatabaseServices.PlotSettings
    Autodesk.AutoCAD.DatabaseServices.PointCloudColorMap
    Autodesk.AutoCAD.DatabaseServices.PointCloudDefEx
    Autodesk.AutoCAD.DatabaseServices.ProxyObject
    Autodesk.AutoCAD.DatabaseServices.RasterImageDef
    Autodesk.AutoCAD.DatabaseServices.RasterVariables
    Autodesk.AutoCAD.DatabaseServices.RenderEnvironment
    Autodesk.AutoCAD.DatabaseServices.RenderGlobal
    Autodesk.AutoCAD.DatabaseServices.RenderSettings
    Autodesk.AutoCAD.DatabaseServices.SectionManager
    Autodesk.AutoCAD.DatabaseServices.SectionSettings
    Autodesk.AutoCAD.DatabaseServices.SectionViewStyle
    Autodesk.AutoCAD.DatabaseServices.Sun
    Autodesk.AutoCAD.DatabaseServices.SymbolTable
    Autodesk.AutoCAD.DatabaseServices.SymbolTableRecord
    Autodesk.AutoCAD.DatabaseServices.TableStyle
    Autodesk.AutoCAD.DatabaseServices.UnderlayDefinition
    Autodesk.AutoCAD.DatabaseServices.Xrecord

Visual Basic

Public abstract Class DBObject
Inherits Autodesk.AutoCAD.GraphicsInterface.Drawable

C#

public abstract class DBObject : Autodesk.AutoCAD.GraphicsInterface.Drawable;

Links

DBObject Methods, DBObject Properties, DBObject Events

See Also

Database, Entity, Curve, IdMapping, DwgFiler, DxfFiler, RXClass, AuditInfo