Database.AddDBObject vs. TransactionManager.AddNewlyCreatedDBObject

[kelidesign]

Is there any difference in usage between Database.AddDBObject and TransactionManager.AddNewlyCreatedDBObject? I recently made a mistake (if there are two identically defined methods, one is a native method and the other is an extended method, no prompt will be given...), I am considering writing a demo to analyze and verify, and submit it to Microsoft, think about design rationality).

Because I had never used AddDBObject and had no impression of it, I accidentally wrote an extension method with the same name and the same parameter list, causing an error in the method I wanted to execute.

Share my method:

    public static void AddDBObject(this Database db, DBObject obj)
    {
        if (!db.IsValid())
            throw new InvalidDataException(nameof(db));

        if (!obj.IsValid())
            throw new InvalidDataException(nameof(obj));

        db.GetTopTransaction().AddNewlyCreatedDBObject(obj, true);
    }

[ActivistInvestor]

AddDBObject() adds an object to the Database. 

AddNewlyCreatedDBObject() adds an object to the transaction.

One has nothing to do with the other.

You rarely need to call AddDBObject() because adding a DBObject to an owner (e.g., BlockTableRecord.AppendEntity) also adds it to the Database.

[kelidesign]

I still can't intuitively feel the difference and when to use it. It would be great if I could explain a specific example. Thanks.

[daniel_cadext · Accepted solution]

AddDBObject appends an object to the database, but it has no owner, orphaned objects may not be saved. So, you should avoid AddDBObject unless you have a specific reason to use it.

BlockTableRecord.AppendEntity appends an object to the database AND applies an owner, which in this case, is the BlockTableRecord, such as modelspace or paperspace

AddNewlyCreatedDBObject is a transaction, this for more for memory management, undo redo

[ActivistInvestor]

I would suggest finding a better language translator.

[kelidesign]

Sorry, it may have something to do with the simplicity of my expression. I will pay attention to it, thank you.