CAD .NET开发 教程(C#)——第三章

第 3 章 数据库基础: 创建我们自己的 Employee 对象

打开 Lab3 文件夹下的 Lab3 工程文件，或或接着 Lab2 的代码。在这一章中，我们将创 建一个‘Employee 对象’（包括一个圆，一个椭圆和一个多行文本对象），这个对象属于 一个自定义的 EmployeeBlock’块（这个块驻留在‘EmployeeLayer’层，当在模型空间插 入这个块的时候，‘EmployeeLayer’层就会拥有这个块的一个块索引）。本章的每一个步 骤中的代码都可以运行，这样做的目的可以使你更清楚地知道每一部分代码完成的功能。第 一步将简要说明一下如何在模型空间创建一个圆。
这一章的重点是在 AutoCAD 中访问数据库的基础。主要内容包括事务处理
（Transaction）、对象 Id（ObjectId）、符号表（symbol tables，如块表 BlockTable 和 层表 LayerTable）以及对象引用。使用的其它一些对象如颜色 Color、三维点 Point3d 和三 维向量 Vector3d，都和各自的步骤有关，但重点应该放在数据库基础上。
1)创建一个名为‘CREATE’的命令，它调用函数 CreateEmployee()。这个函数用来在模 型空间(MODELSPACE)的（10，10，0）点处创建一个半径为 2.0 的圆：
[CommandMethod("test")]
public void createCircle()
{ //首先声明我们要使用的对象
Circle circle; //这个是我们要加入到模型空间的圆
BlockTableRecord btr;//要加入圆，我们必须打开模型空间
BlockTable bt; //要打开模型空间，我们必须通过块表(BlockTable)来访问它

//我们使用一个名为‘Transaction’的对象，把函数中有关数据库的操作封装起来 Transaction trans;
//使用 TransactionManager 的 StartTransaction()成员来开始事务处理
trans =
HostApplicationServices.WorkingDatabase.TransactionManager.StartTransaction();

//现在创建圆……请仔细看这些参数——注意创建 Point3d 对象的‘New’和 Vector3d 的 静态成员 ZAxis
circle = new Circle(new Point3d(10, 10, 0), Vector3d.ZAxis, 2);
bt =
(BlockTable)trans.GetObject(HostApplicationServices.WorkingDatabase.BlockTableI d, OpenMode.ForRead);
//使用当前的空间 Id 来获取块表记录——注意我们是打开它用来写入
btr =
(BlockTableRecord)trans.GetObject(HostApplicationServices.WorkingDatabase.Curre ntSpaceId,OpenMode.ForWrite );
//现在使用 btr 对象来加入圆
btr.AppendEntity(circle);
trans.AddNewlyCreatedDBObject(circle, true); //并确定事务处理知道要加入圆！
//一旦完成以上操作，我们就提交事务处理，这样以上所做的改变就被保存了……
trans.Commit();
//…然后销毁事务处理，因为我们已经完成了相关的操作（事务处理不是数据库驻留对象， 可以销毁）
trans.Dispose();

}
请仔细阅读一下上面的代码块的结构，可以通过注释来了解相关的细节。
注意：要编译代码，你必须导入 Autodesk.AutoCAD.DatabaseServices 和
Autodesk.AutoCAD.Geometry 命名空间
运行这个函数来看看它是否可行。应该会在图形中创建一个在(10,10,0)处的半径为 2.0 的 白色的圆。
2) 我们可以减少代码的输入量，这可以通过声明一个 Database 变量代替 HostApplicationServices.WorkingDatabase 来实现：
Database db = HostApplicationServices.WorkingDatabase;
使用这个变量来代替在代码中出现的 HostApplicationServices.WorkingDatabase。
3)在上面的代码中，我们没有使用任何异常处理，而异常处理对一个正确的.NET 应用程序 来说是非常重要的。我们要养成使用异常处理的好习惯，所以让我们在这个函数中加入 try-catch-finally。
4)为了使代码紧凑，我们可以把许多变量的声明和初始化放在同一个语句中。现在，你的 代码看起来应该是这样的：
[CommandMethod("CREATE")]
public void CREATEEMPLOYEE()
{ Database db = HostApplicationServices.WorkingDatabase;
Transaction trans = db.TransactionManager.StartTransaction();
try
{
Circle circle = new Circle(new Point3d(10, 10, 0), Vector3d.ZAxis, 2); BlockTable bt = (BlockTable)trans.GetObject(db.BlockTableId, OpenMode.ForRead);
BlockTableRecord btr =
(BlockTableRecord)trans.GetObject(HostApplicationServices.WorkingDatabase.Curre ntSpaceId,OpenMode.ForWrite);
btr.AppendEntity(circle);
trans.AddNewlyCreatedDBObject(circle, true);
trans.Commit();
}

catch
{
ed.WriteMessage("Error ");
}
finally
{
trans.Dispose();
}
}
End Function
运行你的代码来进行测试……
上面的 catch 块只显示一个错误信息。实际的清理工作是在 finally 块中进行的。这样 做的理由是如果在事务处理被提交（Commit()）之前，Dispose()被调用的话，事务处理会 被 销毁。我们认为如果在 trans.Commit()之前出现任何错误的话，你应该销毁事务处理（因 为 Commit 将永远不会被调用）。如果在 Dispose()之前调用了 Commit()，也就是说没有任 何错误发生，那么事务处理将会被提交给数据库。
所以基于上面的分析，Catch 块其实并不是必须的，因为它只用来通知用户程序出现了一个 错误。它将在下面的代码中被去掉。
5)现在让我们在 Employee 加入剩下的部分：椭圆和多行文本的实例。
多行文本实体：
中心点应该与圆心的创建一样：
（建议：创建一个名为‘center’而值为 10,10,0 的 Point3d 变量
来表示中心点）
多行文本的内容可以是你的名字。
椭圆（提示：你可以先看一下 Ellipse 的构造函数）
法向量应该沿着 Z 轴（请查看 Vector3d 类型）
主轴设为 Vector3d(3,0,0)（提示：不要忘了用 new） 半径比例设为 0.5
椭圆还必须闭合（也就是说，开始和结束点必须相同）
运行你的代码来进行测试……应该可以生成一个圆、一个椭圆和一个中心点在 10,10,0 的多行文本。
注意：和事务处理对象有关的.NET API 中的 Try-Catch-Finally 块结构，应该是异常 观察者。实际上我们是在 try 块中实例化对象的，但没有显式地销毁它们。当产生异常的时 候可能会产生问题，特别是当观察者注意到我们实际上用的是封装的非托管对象！记住，当 资源不再使用的时候，垃圾收集机制就会回收内存。垃圾收集机制会不时的调用封装类的 Dispose()方法，删除非托管对象。
这里还要注意的是 Dispose()作用于封装的非托管类对象的方式取决于对象是否是数 据库驻留对象。由非数据库驻留对象调用的 Dispose()会删除非托管对象，而由数据库驻留 对象调用的 Dispose()只是关闭它们。

6) 接下来让我们来创建一个新的函数，它用来新建一个颜色为黄色，名字为
“EmployeeLayer” 的 AutoCAD 层。
这个函数应该检查是否这个层已经存在，但不管这个层是否存在，函数都应该返回
“EmployeeLayer”的 ObjectId。下面是这个函数的代码：
public ObjectId CreateLayer()
{
ObjectId layerId; //它返回函数的值
Database db = HostApplicationServices.WorkingDatabase;
Transaction trans = db.TransactionManager.StartTransaction();
//首先取得层表……
LayerTable lt = (LayerTable)trans.GetObject(db.LayerTableId, OpenMode.ForWrite); //检查 EmployeeLayer 层是否存在……
if (lt.Has("EmployeeLayer"))
{
layerId = lt["EmployeeLayer"];
}
else
{
//如果 EmployeeLayer 层不存在，就创建它 LayerTableRecord ltr = new LayerTableRecord();
ltr.Name = "EmployeeLayer"; //设置层的名字
ltr.Color = Color.FromColorIndex(ColorMethod.ByAci, 2); layerId = lt.Add(ltr);
trans.AddNewlyCreatedDBObject(ltr, true);
}

trans.Commit(); trans.Dispose(); return layerId;
}
是不是觉得这个函数的基本结构与在模型空间加入实体的代码比较类似？访问数据库的 方法都是这样的：使用事务处理来获取数据库对象，在符号表（模型空间所在的块表也是符 号表之一）中加入实体，然后让事务处理知道。
7)在这个函数中加入异常处理，就像在 CreateEmployee 函数中的一样。
8)接下来，改变新建层的颜色。下面是实现的代码片断，请把它加入到你的代码中： ltr.Color = Color.FromColorIndex(ColorMethod.ByAci, 2)
注 意 ：ColorMethod.ByAci可以让我们使用AutoCAD ACI颜色索引……这里为2（表示黄色 ）。 创建一个名为 CreateEmployee 新的函数 把命令属性“CREATE”移动到 CreateEmployee()

修改 CreateEmployeeDefintion()来返
回新创建的块“EmployeeBlock”的 ObjectId，操作的步骤请参考 CreateLayer()的作法。 你需要修改 CreateEmployeeDefintion() 来查看块表中是否已包含“EmployeeBlock”块，如果包含这个块，则返回它的 ObjectId（做 法与 CreateLayer()一样）。

提示：把‘bt’的声明语句移动到 try 块的顶部，使用 BlockTable.Has()方法，把其它的 代码移动到 else 语句：
try{
//获取 BlockTable 对象
BlockTable bt = (BlockTable)trans.GetObject(db.BlockTableId, OpenMode.ForWrite);
if ((bt.Has("EmployeeBlock")))
{
newBtrId =bt["EmployeeBlock"];
}
else{ …