C#.NET教程: 創(chuàng)建我們自己的Employee對(duì)象
在本文中,我們將創(chuàng)建一個(gè)‘Employee 對(duì)象’(包括一個(gè)圓,一個(gè)橢圓和一個(gè)多行文本對(duì)象),這個(gè)對(duì)象屬于一個(gè)自定義的EmployeeBlock’塊(這個(gè)塊駐留在‘EmployeeLayer’層,當(dāng)在模型空間插入這個(gè)塊的時(shí)候,‘EmployeeLayer’層就會(huì)擁有這個(gè)塊的一個(gè)塊索引)。本章的每一個(gè)步驟中的代碼都可以運(yùn)行,這樣做的目的可以使你更清楚地知道每一部分代碼完成的功能。第一步將簡(jiǎn)要說明一下如何在模型空間創(chuàng)建一個(gè)圓。
這一章的重點(diǎn)是在AutoCAD中訪問數(shù)據(jù)庫的基礎(chǔ)。主要內(nèi)容包括事務(wù)處理(Transaction)、對(duì)象Id(ObjectId)、符號(hào)表(symbol tables,如塊表BlockTable和層表LayerTable)以及對(duì)象引用。使用的其它一些對(duì)象如顏色Color、三維點(diǎn)Point3d和三維向量Vector3d,都和各自的步驟有關(guān),但重點(diǎn)應(yīng)該放在數(shù)據(jù)庫基礎(chǔ)上。
1) 創(chuàng)建一個(gè)名為‘CREATE’的命令,它調(diào)用函數(shù)CreateEmployee()。這個(gè)函數(shù)用來在模型空間(MODELSPACE)的(10,10,0)點(diǎn)處創(chuàng)建一個(gè)半徑為2.0的圓:
- [CommandMethod("test")]
- public void createCircle()
- {
- //首先聲明我們要使用的對(duì)象
- Circle circle; //這個(gè)是我們要加入到模型空間的圓
- BlockTableRecord btr;//要加入圓,我們必須打開模型空間
- BlockTable bt; //要打開模型空間,我們必須通過塊表(BlockTable)來訪問它
- //我們使用一個(gè)名為‘Transaction’的對(duì)象,把函數(shù)中有關(guān)數(shù)據(jù)庫的操作封裝起來
- Transaction trans;
- //使用TransactionManager的StartTransaction()成員來開始事務(wù)處理
- trans = HostApplicationServices.WorkingDatabase.TransactionManager.StartTransaction();
- //現(xiàn)在創(chuàng)建圓……請(qǐng)仔細(xì)看這些參數(shù)——注意創(chuàng)建Point3d對(duì)象的‘New’和Vector3d的靜態(tài)成員ZAxis
- circle = new Circle(new Point3d(10, 10, 0), Vector3d.ZAxis, 2);
- bt = (BlockTable)trans.GetObject(HostApplicationServices.WorkingDatabase.BlockTableId, OpenMode.ForRead);
- //使用當(dāng)前的空間Id來獲取塊表記錄——注意我們是打開它用來寫入
- btr = (BlockTableRecord)trans.GetObject(HostApplicationServices.WorkingDatabase.CurrentSpaceId,OpenMode.ForWrite );
- //現(xiàn)在使用btr對(duì)象來加入圓
- btr.AppendEntity(circle);
- trans.AddNewlyCreatedDBObject(circle, true); //并確定事務(wù)處理知道要加入圓!
- //一旦完成以上操作,我們就提交事務(wù)處理,這樣以上所做的改變就被保存了……
- trans.Commit();
- //…然后銷毀事務(wù)處理,因?yàn)槲覀円呀?jīng)完成了相關(guān)的操作(事務(wù)處理不是數(shù)據(jù)庫駐留對(duì)象,可以銷毀)
- trans.Dispose();
- }
請(qǐng)仔細(xì)閱讀一下上面的代碼塊的結(jié)構(gòu),可以通過注釋來了解相關(guān)的細(xì)節(jié)。
注意:要編譯代碼,你必須導(dǎo)入Autodesk.AutoCAD.DatabaseServices 和Autodesk.AutoCAD.Geometry命名空間
運(yùn)行這個(gè)函數(shù)來看看它是否可行。應(yīng)該會(huì)在圖形中創(chuàng)建一個(gè)在(10,10,0)處的半徑為2.0的白色的圓。
2) 我們可以減少代碼的輸入量,這可以通過聲明一個(gè)Database變量代替HostApplicationServices.WorkingDatabase來實(shí)現(xiàn):
- Database db = HostApplicationServices.WorkingDatabase;
使用這個(gè)變量來代替在代碼中出現(xiàn)的HostApplicationServices.WorkingDatabase。
3) 在上面的代碼中,我們沒有使用任何異常處理,而異常處理對(duì)一個(gè)正確的.NET應(yīng)用程序來說是非常重要的。我們要養(yǎng)成使用異常處理的好習(xí)慣,所以讓我們?cè)谶@個(gè)函數(shù)中加入try-catch-finally。
4) 為了使代碼緊湊,我們可以把許多變量的聲明和初始化放在同一個(gè)語句中?,F(xiàn)在,你的代碼看起來應(yīng)該是這樣的:
- [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.CurrentSpaceId,OpenMode.ForWrite);
- btr.AppendEntity(circle);
- trans.AddNewlyCreatedDBObject(circle, true);
- trans.Commit();
- }
- catch
- {
- ed.WriteMessage("Error ");
- }
- finally
- {
- trans.Dispose();
- }
- }
- End Function
運(yùn)行你的代碼來進(jìn)行測(cè)試……
上面的catch塊只顯示一個(gè)錯(cuò)誤信息。實(shí)際的清理工作是在finally塊中進(jìn)行的。這樣做的理由是如果在事務(wù)處理被提交(Commit())之前,Dispose()被調(diào)用的話,事務(wù)處理會(huì)被銷毀。我們認(rèn)為如果在trans.Commit()之前出現(xiàn)任何錯(cuò)誤的話,你應(yīng)該銷毀事務(wù)處理(因?yàn)镃ommit將永遠(yuǎn)不會(huì)被調(diào)用)。如果在Dispose()之前調(diào)用了Commit(),也就是說沒有任何錯(cuò)誤發(fā)生,那么事務(wù)處理將會(huì)被提交給數(shù)據(jù)庫。
所以基于上面的分析,Catch塊其實(shí)并不是必須的,因?yàn)樗挥脕硗ㄖ脩舫绦虺霈F(xiàn)了一個(gè)錯(cuò)誤。它將在下面的代碼中被去掉。
5) 現(xiàn)在讓我們?cè)贓mployee對(duì)象加入剩下的部分:橢圓和多行文本的實(shí)例。
多行文本實(shí)體:
中心點(diǎn)應(yīng)該與圓心的創(chuàng)建一樣:
(建議:創(chuàng)建一個(gè)名為‘center’而值為10,10,0的Point3d變量來表示中心點(diǎn))
多行文本的內(nèi)容可以是你的名字。
橢圓(提示:你可以先看一下Ellipse的構(gòu)造函數(shù))
法向量應(yīng)該沿著Z軸(請(qǐng)查看Vector3d類型)
主軸設(shè)為Vector3d(3,0,0)(提示:不要忘了用new)
半徑比例設(shè)為0.5
橢圓還必須閉合(也就是說,開始和結(jié)束點(diǎn)必須相同)
運(yùn)行你的代碼來進(jìn)行測(cè)試……應(yīng)該可以生成一個(gè)圓、一個(gè)橢圓和一個(gè)中心點(diǎn)在10,10,0的多行文本。
注意:和事務(wù)處理對(duì)象有關(guān)的.NET API中的Try-Catch-Finally塊結(jié)構(gòu),應(yīng)該是異常觀察者。實(shí)際上我們是在try塊中實(shí)例化對(duì)象的,但沒有顯式地銷毀它們。當(dāng)產(chǎn)生異常的時(shí)候可能會(huì)產(chǎn)生問題,特別是當(dāng)觀察者注意到我們實(shí)際上用的是封裝的非托管對(duì)象!記住,當(dāng)資源不再使用的時(shí)候,垃圾收集機(jī)制就會(huì)回收內(nèi)存。垃圾收集機(jī)制會(huì)不時(shí)的調(diào)用封裝類的Dispose()方法,刪除非托管對(duì)象。
這里還要注意的是Dispose()作用于封裝的非托管類對(duì)象的方式取決于對(duì)象是否是數(shù)據(jù)庫駐留對(duì)象。由非數(shù)據(jù)庫駐留對(duì)象調(diào)用的Dispose()會(huì)刪除非托管對(duì)象,而由數(shù)據(jù)庫駐留對(duì)象調(diào)用的Dispose()只是關(guān)閉它們。
6) 接下來讓我們來創(chuàng)建一個(gè)新的函數(shù),它用來新建一個(gè)顏色為黃色,名字為“EmployeeLayer” 的AutoCAD層。
這個(gè)函數(shù)應(yīng)該檢查是否這個(gè)層已經(jīng)存在,但不管這個(gè)層是否存在,函數(shù)都應(yīng)該返回“EmployeeLayer”的ObjectId。下面是這個(gè)函數(shù)的代碼:
- public ObjectId CreateLayer()
- {
- ObjectId layerId; //它返回函數(shù)的值
- 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層不存在,就創(chuàng)建它
- LayerTableRecord ltr = new LayerTableRecord();
- ltr.Name = "EmployeeLayer"; //設(shè)置層的名字
- ltr.Color = Color.FromColorIndex(ColorMethod.ByAci, 2);
- layerId = lt.Add(ltr);
- trans.AddNewlyCreatedDBObject(ltr, true);
- }
- trans.Commit();
- trans.Dispose();
- return layerId;
- }
是不是覺得這個(gè)函數(shù)的基本結(jié)構(gòu)與在模型空間加入實(shí)體的代碼比較類似?訪問數(shù)據(jù)庫的方法都是這樣的:使用事務(wù)處理來獲取數(shù)據(jù)庫對(duì)象,在符號(hào)表(模型空間所在的塊表也是符號(hào)表之一)中加入實(shí)體,然后讓事務(wù)處理知道。
7) 在這個(gè)函數(shù)中加入異常處理,就像在CreateEmployee函數(shù)中的一樣。
8) 接下來,改變新建層的顏色。下面是實(shí)現(xiàn)的代碼片斷,請(qǐng)把它加入到你的代碼中:
- ltr.Color = Color.FromColorIndex(ColorMethod.ByAci, 2)
注意:ColorMethod.ByAci可以讓我們使用AutoCAD ACI顏色索引……這里為2(表示黃色)。
回到CreateEmployee()函數(shù),加入把上面創(chuàng)建的幾個(gè)實(shí)體設(shè)置到EmployeeLayer層的代碼。聲明一個(gè)類型為ObjectId的變量,用CreateLayer函數(shù)的返回值給它賦值。使用每個(gè)實(shí)體(文本、圓和橢圓)的LayerId屬性設(shè)置它們所在的層。
例如: text.LayerId = empId
運(yùn)行代碼來查看“EmployeeLayer”層是否已被創(chuàng)建,所有已創(chuàng)建的實(shí)體是否都在這一層上(應(yīng)該顯示為黃色)
10) 現(xiàn)在為各個(gè)實(shí)體設(shè)置不同的顏色,可以使用ColorIndex屬性(ColorIndex屬性表示AutoCAD的顏色)
圓為紅色-1
橢圓為綠色-3
文本為黃色-2
運(yùn)行代碼,看看實(shí)體的顏色是否為設(shè)置的值,即使這些實(shí)體是在“EmployeeLayer”層上。
11) 接下來,我們要在AutoCAD數(shù)據(jù)庫中創(chuàng)建一個(gè)獨(dú)立的塊,然后把它插入到塊表而不是模型空間中。
首先把CreateEmployee函數(shù)的名字改為CreateEmployeeDefinition()。
加入以下代碼來創(chuàng)建一個(gè)獨(dú)立的塊:
- BlockTableRecord newBtr = new BlockTableRecord();
- newBtr.Name = "EmployeeBlock";
- newBtrId = bt.Add(newBtr);
- trans.AddNewlyCreatedDBObject(newBtr, true);
12) 現(xiàn)在,請(qǐng)稍微改動(dòng)一下加入實(shí)體到模型空間的代碼(改為加入塊到塊表中,記得加入前要打開塊表)。
現(xiàn)在運(yùn)行代碼,然后使用INSERT命令來檢查是否可以正確插入這個(gè)塊。
13) 最后,我們要?jiǎng)?chuàng)建一個(gè)位于模型空間的塊索引,它表示上面創(chuàng)建的塊的一個(gè)實(shí)例。這一步留給大家練習(xí)。
下面是你要遵循的最基本的步驟:
創(chuàng)建一個(gè)名為CreateEmployee新的函數(shù)
把命令屬性“CREATE”移動(dòng)到CreateEmployee()
修改CreateEmployeeDefintion()來返回新創(chuàng)建的塊“EmployeeBlock”的ObjectId,操作的步驟請(qǐng)參考CreateLayer()的作法。
你需要修改CreateEmployeeDefintion()來查看塊表中是否已包含“EmployeeBlock”塊,如果包含這個(gè)塊,則返回它的ObjectId(做法與CreateLayer()一樣)。
提示:把‘bt’的聲明語句移動(dòng)到try塊的頂部,使用BlockTable.Has()方法,把其它的代碼移動(dòng)到else語句:
- try
- {
- //獲取BlockTable 對(duì)象
- BlockTable bt = (BlockTable)trans.GetObject(db.BlockTableId, OpenMode.ForWrite);
- if ((bt.Has("EmployeeBlock")))
- {
- newBtrId =bt["EmployeeBlock"];
- }
- else
- {
- …
在新創(chuàng)建的CreateEmployee()函數(shù)中創(chuàng)建一個(gè)新的BlockReference對(duì)象,并把它加入到模型空間。提示:我們可以使用CreateEmployeeDefinition()中引用模型空間的代碼,這些代碼在這里不需要了
在CreateEmployee中調(diào)用CreateEmployeeDefinition()函數(shù),使上面生成的BlockReference對(duì)象的BlockTableRecord()指向CreateEmployeeDefinition()函數(shù)。提示:請(qǐng)參考BlockReference的構(gòu)造函數(shù)。
這樣,我們自己的Employee對(duì)象就創(chuàng)建完成了。
【編輯推薦】