C#与SolidWorks实战：如何通过API获取三维模型参数并实现1:1自动建模

1次阅读

共计 4237 个字符，预计需要花费 11 分钟才能阅读完成。

在传统机械设计流程中，工程师往往需要手动在 SolidWorks 中反复操作：点击草图工具、标注尺寸、拉伸特征 … 这种工作方式存在两个致命问题：

效率低下：一个包含 20 个特征的零件，手动重建可能需要 30 分钟以上
人为错误：在批量修改参数时，容易遗漏或输错关键尺寸

我曾遇到一个实际案例：某客户需要批量修改 500 个法兰零件的螺栓孔距参数，如果手动操作，团队需要连续工作 3 天，而通过 API 自动化处理，仅用 20 分钟就完成了全部修改和校验。

在工业设计自动化领域，常见方案对比：

方案	优势	劣势
SolidWorks API	原生支持特征级操作	学习曲线陡峭
AutoCAD API	二维处理能力强	三维特征支持有限
第三方中间件	跨平台兼容性好	功能阉割严重

选择 SolidWorks API 的核心原因：

直接操作特征树(FeatureTree)，可以精准控制每个建模步骤
支持参数驱动设计 (Parametric Design) 的全套接口
与 SolidWorks 深度集成，避免转换过程中的数据丢失

// 使用 Marshal.GetActiveObject 连接已打开的 SolidWorks 实例
SldWorks swApp;
try 
{swApp = (SldWorks)Marshal.GetActiveObject("SlsldWorks.Application");
}
catch (COMException)
{
    // 如果未启动则创建新实例
    Type swType = Type.GetTypeFromProgID("SldWorks.Application");
    swApp = (SldWorks)Activator.CreateInstance(swType);
    swApp.Visible = true;
}

// 验证连接状态
if (swApp == null) 
{throw new InvalidOperationException("SolidWorks 连接失败");
}

关键点：

优先尝试连接已有实例，避免重复启动消耗资源
必须处理 COM 异常，这是 API 调用中最常见的错误源

ModelDoc2 swModel = swApp.ActiveDoc;
if (swModel == null)
{MessageBox.Show("请先打开模型文件");
    return;
}

// 获取特征管理器
FeatureManager swFeatureMgr = swModel.FeatureManager;

public void TraverseFeatures(Feature feature)
{while (feature != null)
    {
        // 处理当前特征
        ProcessFeature(feature);

        // 处理子特征（如草图内的几何元素）Feature subFeature = feature.GetFirstSubFeature();
        if (subFeature != null)
        {TraverseFeatures(subFeature);
        }

        // 移动到同级下一个特征
        feature = feature.GetNextFeature();}
}

以拉伸特征为例：

private void ProcessExtrudeFeature(Feature feature)
{ExtrudeFeatureData extrudeData = (ExtrudeFeatureData)feature.GetDefinition();

    // 获取深度参数
    double depth = extrudeData.Depth;

    // 获取草图平面信息
    RefPlane refPlane = extrudeData.ReferencePlane;
    double[] planeParams = refPlane.PlaneParams;

    // 获取草图几何
    Sketch sketch = extrudeData.GetSketch();
    SketchSegment[] segments = sketch.GetSketchSegments();

    // 构建参数对象
    var featureParams = new 
    {
        Type = "Extrude",
        Depth = depth,
        Plane = planeParams,
        Segments = segments.Select(s => s.GetType().Name).ToArray()};

    _parameters.Add(featureParams);
}

建议采用分层结构：

{
    "Document": {
        "Units": "MMGS",
        "Templates": "Part.prtdot"
    },
    "Features": [
        {
            "Type": "Sketch",
            "Plane": "Front",
            "Geometry": [{"Type": "Line", "Start": [0,0], "End": [50,0]},
                {"Type": "Arc", "Center": [25,0], "Radius": 25}
            ]
        },
        {
            "Type": "Extrude",
            "SketchId": 0,
            "Direction": "Normal",
            "Depth": 20
        }
    ]
}

public void RebuildModel(ModelDoc2 model, ParameterData parameters)
{
    // 设置文档单位
    model.SetUnits((int)swUnits_e.swMMGS, 0, 0);

    // 按顺序创建特征
    foreach (var feature in parameters.Features)
    {switch (feature.Type)
        {
            case "Sketch":
                CreateSketch(model, feature);
                break;
            case "Extrude":
                CreateExtrude(model, feature);
                break;
            // 其他特征类型...
        }
    }
}

private void CreateSketch(ModelDoc2 model, SketchFeatureData sketchData)
{
    // 选择草图平面
    model.SelectByID("Front Plane", "PLANE", 0, 0, 0);
    model.SketchManager.InsertSketch(true);

    // 创建几何图形
    foreach (var geom in sketchData.Geometry)
    {switch (geom.Type)
        {
            case "Line":
                model.SketchManager.CreateLine(geom.Start[0], geom.Start[1], 0,
                    geom.End[0], geom.End[1], 0);
                break;
            case "Circle":
                model.SketchManager.CreateCircleByRadius(geom.Center[0], geom.Center[1], 0,
                    geom.Radius);
                break;
        }
    }

    // 添加尺寸约束
    AddDimensions(model, sketchData.Dimensions);

    model.SketchManager.InsertSketch(true);
}

private void CreateExtrude(ModelDoc2 model, ExtrudeFeatureData extrudeData)
{
    // 获取草图引用
    Feature sketchFeature = model.FeatureManager.GetFeatures()
        .First(f => f.GetTypeName() == "Sketch" && f.Name == extrudeData.SketchId);

    // 设置拉伸参数
    bool status = model.FeatureManager.FeatureExtrusion3(
        true, false, false, 
        (int)swEndConditions_e.swEndCondBlind, 
        (int)swEndConditions_e.swEndCondBlind,
        extrudeData.Depth, 0, false, false, false, false,
        0, 0, false, false, false, false, false,
        false, false, false);

    if (!status)
    {throw new ApplicationException("拉伸特征创建失败");
    }
}

SolidWorks 内部存储始终使用米制单位，但显示单位可能不同。必须统一转换：

// 将 API 返回值转换为当前文档单位
double GetConvertedValue(PartDoc part, double meterValue)
{return part.ConvertValue(meterValue, (int)swUnitValues_e.swMETER, 
        (int)swUnitValues_e.swMM);
}

重建模型时必须严格保持特征创建顺序：