NX Open C# 对象创建：5种Factory模式与Builder模式应用场景解析

NX OpenC#二次开发设计模式

于 2026-07-07 10:02:28 修改

·本内容遵循CC 4.0 BY-SA版权协议

NX Open C# 对象创建：Factory模式与Builder模式深度实践指南

1. 理解NX Open中的对象创建范式

在NX Open C#二次开发中，对象创建是核心操作之一。系统主要提供了两种设计模式来实现对象创建：Factory模式和Builder模式。这两种模式各有特点，适用于不同的场景。

Factory模式通过专门的工厂类来创建对象，隐藏了对象创建的具体细节。在NX Open中，常见的工厂类包括：

PointCollection：用于创建点对象
CurveCollection：用于创建曲线对象
FeatureCollection：用于创建特征对象

CSHARP

// 使用PointCollection创建点

Point3d coords = new Point3d(3, 5, 0);

PointCollection points = workPart.Points;

Point newPoint = points.CreatePoint(coords);

Builder模式则用于创建复杂对象，通过分步设置属性来构建最终对象。典型的Builder类包括：

SphereBuilder：用于构建球体特征
ExtrudeBuilder：用于构建拉伸特征
BooleanBuilder：用于构建布尔运算特征

CSHARP

// 使用SphereBuilder创建球体

Features.SphereBuilder sphereBuilder = workPart.Features.CreateSphereBuilder(null);

sphereBuilder.Type = SphereBuilder.Types.CenterPointAndDiameter;

sphereBuilder.CenterPoint = new Point3d(0, 0, 0);

sphereBuilder.Diameter.RightHandSide = "50";

NXObject sphereFeature = sphereBuilder.Commit();

2. 五种典型Factory模式应用场景

2.1 PointCollection：简单几何点创建

PointCollection是最基础的工厂类之一，用于创建各种类型的点。它提供了多种创建方法：

CreatePoint()：通过坐标创建点
CreateQuadrantPoint()：创建象限点
CreatePointOnCurve()：在曲线上创建点

关键参数对比表：

方法	参数类型	返回值	适用场景
CreatePoint	Point3d	Point	已知精确坐标
CreateQuadrantPoint	Point3d, Vector3d	Point	创建象限点
CreatePointOnCurve	Curve, double	Point	在曲线上按参数创建

注意：使用PointCollection创建的点默认位于当前工作层，创建后可通过Layer属性修改

2.2 CurveCollection：曲线创建与编辑

CurveCollection提供了丰富的曲线创建功能，包括直线、圆弧、样条曲线等：

CSHARP

// 创建直线示例

Point3d startPt = new Point3d(0, 0, 0);

Point3d endPt = new Point3d(100, 100, 0);

Line line = workPart.Curves.CreateLine(startPt, endPt);

// 创建圆弧示例

Point3d center = new Point3d(0, 0, 0);

Vector3d axis = new Vector3d(0, 0, 1);

Point3d startPoint = new Point3d(50, 0, 0);

Point3d endPoint = new Point3d(0, 50, 0);

Arc arc = workPart.Curves.CreateArc(center, axis, startPoint, endPoint, true);

2.3 FeatureCollection：特征操作的核心接口

FeatureCollection是特征操作的入口，既可以直接创建简单特征，也可以创建Builder对象：

CSHARP

// 直接创建基准平面

Vector3d normal = new Vector3d(0, 0, 1);

Point3d point = new Point3d(0, 0, 0);

DatumPlane datumPlane = workPart.Features.CreateDatumPlane(null, normal, point);

// 创建Builder对象

Features.ExtrudeBuilder extrudeBuilder = workPart.Features.CreateExtrudeBuilder(null);

2.4 AnnotationManager：注释与标注创建

AnnotationManager负责处理工程图中的注释和标注：

CSHARP

// 创建注释

Point3d origin = new Point3d(50, 50, 0);

string[] text = new string[] { "技术要求", "1. 未注公差..." };

Annotation note = workPart.Annotations.CreateNote(text, origin,

AxisOrientation.Horizontal, null, null);

// 创建尺寸标注

Point3d origin1 = new Point3d(0, 0, 0);

Point3d origin2 = new Point3d(100, 0, 0);

LinearDimension dim = workPart.Annotations.CreateLinearDimension(

origin1, origin2, new Point3d(50, -20, 0));

2.5 CAM操作集合：加工编程接口

对于CAM模块，NX Open提供了专门的工厂类：

CSHARP

// 创建铣削操作

CAM.OperationCollection opCollection = camSetup.CAMOperationCollection;

CAM.MillingOperation millingOp = opCollection.CreateHoleMakingBuilder();

3. Builder模式的三种典型应用

3.1 SphereBuilder：参数化球体创建

SphereBuilder提供了完整的球体创建控制：

CSHARP

Features.SphereBuilder sphereBuilder = workPart.Features.CreateSphereBuilder(null);

sphereBuilder.Type = SphereBuilder.Types.CenterPointAndDiameter;

sphereBuilder.CenterPoint = new Point3d(0, 0, 0);

sphereBuilder.Diameter.RightHandSide = "50";

sphereBuilder.BooleanOption.Type = BooleanOperation.BooleanType.Create;

// 提交创建

NXObject sphereFeature = sphereBuilder.Commit();

sphereBuilder.Destroy();

关键属性说明：

Type：定义球体创建方式（中心点+直径/圆弧）
Diameter：设置直径表达式
BooleanOption：控制布尔操作类型

3.2 ExtrudeBuilder：复杂拉伸特征

ExtrudeBuilder用于创建拉伸特征，支持丰富的配置选项：

CSHARP

// 创建拉伸Builder

Features.ExtrudeBuilder extrudeBuilder = workPart.Features.CreateExtrudeBuilder(null);

// 设置截面曲线

Section section = workPart.Sections.CreateSection();

extrudeBuilder.Section = section;

section.AddCurve(profileCurve);

// 设置拉伸方向

Vector3d direction = new Vector3d(0, 0, 1);

extrudeBuilder.Direction = direction;

// 设置拉伸限制

extrudeBuilder.Limits.StartExtend.Value.RightHandSide = "0";

extrudeBuilder.Limits.EndExtend.Value.RightHandSide = "100";

// 提交创建

NXObject extrudeFeature = extrudeBuilder.Commit();

extrudeBuilder.Destroy();

3.3 BooleanBuilder：布尔运算控制

BooleanBuilder用于处理实体间的布尔运算：

CSHARP

// 创建布尔Builder

Features.BooleanBuilder booleanBuilder = workPart.Features.CreateBooleanBuilder(null);

// 设置目标和工具实体

booleanBuilder.Target = targetBody;

booleanBuilder.Tool = toolBody;

booleanBuilder.Operation = BooleanOperation.BooleanType.Unite;

// 提交布尔运算

NXObject booleanFeature = booleanBuilder.Commit();

booleanBuilder.Destroy();

4. Factory与Builder模式的选择策略

在实际开发中，选择哪种模式取决于对象复杂度和所需控制级别：

决策树：

对象是否简单且参数固定？
- 是 → 使用Factory模式直接创建
- 否 → 进入下一步
是否需要分步设置多个属性？
- 是 → 使用Builder模式
- 否 → 使用Factory模式
是否需要支持撤销/重做操作？
- 是 → Builder模式更合适
- 否 → 两种模式均可

典型场景对比：

场景	推荐模式	原因
创建简单几何元素	Factory	代码简洁，一步完成
创建参数化特征	Builder	需要设置多个参数
编辑现有特征	Builder	支持属性修改和预览
批量创建相似对象	Factory	效率更高

5. 实战技巧与常见问题解决

5.1 类型转换最佳实践

Builder提交后需要进行正确的类型转换：

CSHARP

// 安全类型转换示例

NXObject result = builder.Commit();

if (result is Features.Sphere)

{

Features.Sphere sphere = (Features.Sphere)result;

// 处理球体特征

}

else

{

// 处理其他类型或报错

}

5.2 对象生命周期管理

正确处理Builder对象的生命周期：

CSHARP

try

{

Features.ExtrudeBuilder builder = workPart.Features.CreateExtrudeBuilder(null);

// 配置builder...

NXObject feature = builder.Commit();

}

finally

{

if (builder != null)

{

builder.Destroy();

}

5.3 性能优化建议

对于批量创建，优先使用Factory模式
重用Builder对象时，注意调用Reset方法
复杂操作考虑使用事务包装

CSHARP

using (PartLoadStatus loadStatus = null)

using (Session.UndoMark mark = theSession.SetUndoMark(

Session.MarkVisibility.Visible, "Create Features"))

{

// 批量创建操作...

theSession.UpdateManager.DoUpdate(mark);

}

在实际项目中，合理选择和使用这两种创建模式，可以显著提高代码的可维护性和执行效率。根据我的经验，Builder模式在参数化设计场景中特别有用，而Factory模式则更适合于简单对象的快速创建。