System.Object
  └── ModelObject (abstract)
        ├── Part (abstract) → Beam, ContourPlate, Brep, BentPlate...
        ├── BaseComponent (abstract) → Connection, Component, CustomPart...
        ├── Assembly
        └── Weld, BoltArray, RebarGroup, Load... 等共 61 种类型

关键特征：
• ModelObject 声明为 abstract，不能直接实例化
• 实现 IComparable 和 IEquatable 接口
• 标记 [Serializable] 和 [ClassInterface]，支持 COM 互操作
• ModelObjectEnum 定义了全部 61 种模型对象类型标识符

重要提醒：构造后的 ModelObject 仅存在于内存中，尚未写入 Tekla 模型数据库。必须显式调用 Insert() 方法才能将对象持久化到模型中。

另外还存在一个私有枚举 PropertySourceEnum（SOURCE_UDA / SOURCE_REPORT / SOURCE_ALL_UDAS），用于区分属性来源，仅内部使用。

using System;
using Tekla.Structures.Model;
using Tekla.Structures.Geometry3d;

public void CreateBeamExample()
{
    // 创建一个新的 Beam 对象（继承自 ModelObject）
    Beam myBeam = new Beam();

    // 此时 myBeam.Identifier.ID == 0（无效），仅存在于内存
    Console.WriteLine($"Before Insert - ID: {myBeam.Identifier.ID}");  // 输出: 0

    // 设置必要属性
    myBeam.StartPoint = new Point(0, 0, 0);
    myBeam.EndPoint = new Point(0, 0, 5000);
    myBeam.Profile.ProfileString = "HEA400";
    myBeam.Material.MaterialString = "S235JR";
    myBeam.Class = "2";  // 构件等级

    // 调用 Insert() 将对象写入模型数据库
    bool insertSuccess = myBeam.Insert();

    if (insertSuccess)
    {
        Console.WriteLine($"Beam inserted! ID: {myBeam.Identifier.ID}");
        Console.WriteLine($"Label: {myBeam.Identifier}");
        // 插入后 Identifier.ID 变为有效值（非零正整数）
    }
    else
    {
        Console.WriteLine("Failed to insert beam. Check geometry and properties.");
        // 常见失败原因：起点终点重合、型材不存在、材料无效等
    }
}

public void QueryAndModifyBeam()
{
    // 通过 Identifier 选择已有对象
    Beam beamToQuery = new Beam();
    beamToQuery.Identifier = new Identifier(123456);  // 已知的目标 ID

    if (beamToQuery.Select())  // 从数据库加载数据
    {
        // ===== 读取基本属性 =====
        Console.WriteLine($"Start: {beamToQuery.StartPoint}");
        Console.WriteLine($"End:   {beamToQuery.EndPoint}");
        Console.WriteLine($"Profile: {beamToQuery.Profile.ProfileString}");

        // ===== 读取用户自定义属性 (UDA) =====
        string commentValue = "";
        if (beamToQuery.GetUserProperty("COMMENT", ref commentValue))
        {
            Console.WriteLine($"Comment UDA: {commentValue}");
        }

        double weight = 0;
        if (beamToQuery.GetUserProperty("WEIGHT", ref weight))
        {
            Console.WriteLine($"Weight UDA: {weight} kg");
        }

        // ===== 读取报告属性 =====
        string reportName = "";
        beamToQuery.GetReportProperty("NAME", ref reportName);
        Console.WriteLine($"Report NAME: {reportName}");

        // ===== 读取修改时间和同步状态 =====
        Console.WriteLine($"Modification Time: {beamToQuery.ModificationTime}");
        Console.WriteLine($"Is Up To Date: {beamToQuery.IsUpToDate}");

        // ===== 读取施工阶段 =====
        Phase currentPhase;
        if (beamToQuery.GetPhase(out currentPhase))
        {
            Console.WriteLine($"Phase: {currentPhase.PhaseNumber} - {currentPhase.PhaseName}");
        }

        // ===== 修改属性 =====
        beamToQuery.Class = "3";  // 更改构件等级

        // 修改 UDA
        beamToQuery.SetUserProperty("COMMENT", "Modified by API");
        beamToQuery.SetUserProperty("WEIGHT", 1234.5);

        // 提交修改到数据库
        bool modifyOk = beamToQuery.Modify();
        Console.WriteLine($"Modify result: {modifyOk}");
    }
    else
    {
        Console.WriteLine("Object not found or selection failed.");
    }
}

public bool DeleteModelObjectByIdentifier(long objectId)
{
    try
    {
        // 使用 Beam 作为示例，任何 ModelObject 子类均可
        Beam targetBeam = new Beam();
        targetBeam.Identifier = new Identifier(objectId);

        // 先 Select 验证对象是否存在
        if (!targetBeam.Select())
        {
            Console.WriteLine($"Object with ID={objectId} does not exist.");
            return false;
        }

        // 执行删除操作
        bool deleteResult = targetBeam.Delete();

        if (deleteResult)
        {
            Console.WriteLine($"Successfully deleted object ID={objectId}");
            // 删除后 Identifier.ID 被置为 0
            Console.WriteLine($"ID after delete: {targetBeam.Identifier.ID}");
        }
        else
        {
            Console.WriteLine($"Delete failed for object ID={objectId}");
            // 可能原因：权限不足、对象被锁定、被其他对象引用等
        }

        return deleteResult;
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Error during delete: {ex.Message}");
        return false;
    }
}

// 批量删除示例：删除特定装配体内的所有构件
public void DeleteAllComponentsInAssembly(long assemblyId)
{
    Assembly asm = new Assembly();
    asm.Identifier = new Identifier(assemblyId);

    if (asm.Select())
    {
        ModelObjectEnumerator children = asm.GetChildren();
        int deletedCount = 0;

        foreach (ModelObject child in children)
        {
            if (child.Delete())
                deletedCount++;
        }

        Console.WriteLine($"Deleted {deletedCount} child objects from assembly.");
    }
}

using System.Collections;

public void EnumerateAllBeams()
{
    Model model = new Model();

    // ===== 方式一：获取所有 Beam 类型对象 =====
    ModelObjectEnumerator beamEnumerator =
        model.GetModelObjectSelector().GetAllObjectsWithType(
            ModelObject.ModelObjectEnum.BEAM);

    ArrayList beamList = new ArrayList();

    while (beamEnumerator.MoveNext())
    {
        Beam currentBeam = beamEnumerator.Current as Beam;
        if (currentBeam != null && currentBeam.Select())
        {
            beamList.Add(currentBeam);

            // 读取每根梁的信息
            string profile = "";
            if (currentBeam.GetUserProperty("PROFILE", ref profile))
            {
                Console.WriteLine($"[{currentBeam.Identifier.ID}] " +
                    $"({currentBeam.StartPoint.X:F0}, {currentBeam.StartPoint.Y:F0}, {currentBeam.StartPoint.Z:F0}) " +
                    $"-> Profile: {profile}");
            }
        }
    }
    Console.WriteLine($"Total beams found: {beamList.Count}");

    // ===== 方式二：遍历装配体及其子对象 =====
    ModelObjectEnumerator asmEnumerator =
        model.GetModelObjectSelector().GetAllObjectsWithType(
            ModelObject.ModelObjectEnum.ASSEMBLY);

    while (asmEnumerator.MoveNext())
    {
        Assembly asm = asmEnumerator.Current as Assembly;
        if (asm != null && asm.Select())
        {
            Console.WriteLine($"\nAssembly ID: {asm.Identifier.ID}");

            // 获取装配体的所有子对象
            ModelObjectEnumerator children = asm.GetChildren();
            while (children.MoveNext())
            {
                ModelObject child = children.Current;

                // 获取子对象的父组件信息
                BaseComponent father = child.GetFatherComponent();
                string fatherInfo = father != null ?
                    father.Identifier.ToString() : "(none)";

                Console.WriteLine($"  Child [{child.GetType().Name}] " +
                    $"ID={child.Identifier.ID}, FatherComp={fatherInfo}");

                // 读取子对象的坐标系统
                CoordinateSystem coordSys = child.GetCoordinateSystem();
                if (coordSys != null)
                {
                    Console.WriteLine($"    Origin: {coordSys.Origin}");
                }
            }
        }
    }

    // ===== 方式三：按条件筛选 + 排序 =====
    ModelObjectEnumerator allObjects =
        model.GetModelObjectSelector().GetAllObjects();

    ArrayList sortedList = new ArrayList();
    while (allObjects.MoveNext())
    {
        ModelObject obj = allObjects.Current;
        sortedList.Add(obj);
    }

    // 利用 IComparable 接口进行排序
    sortedList.Sort();  // 按 Identifier.ID 升序排列

    Console.WriteLine("\n--- Sorted objects by ID ---");
    foreach (ModelObject obj in sortedList)
    {
        Console.WriteLine($"  {obj.GetType().Name,-20} ID={obj.Identifier.ID}");
    }
}

性能优化建议：
1. 批量操作优于单条操作 — 使用 GetAllUserProperties 一次性获取所有 UDA
2. 减少 Select 调用 — 通过模型选择器遍历得到的对象已经过 Select
3. 避免不必要的 ModificationTime 读取 — 大批量遍历时跳过此属性
4. 事务性操作 — 对于大批量插入/修改，使用 Model.CommitChanges() 进行事务管理