C#自訂資料詳解

C#語言有很多值得學習的地方，這裡我們主要介紹C#自訂資料，包括介紹每一個由 DBObject派生的對象都擁有儲存C#自訂資料的擴充字典等方面。

我們將建立一個新的字典對象，它用來表示我們僱員就職的 ‘Acme 公司‘（ 呵呵，當然是虛構的一家公司）的部門。這個“部門”字典對象將包含一個表示 部門經理的記錄。我們還會加入代碼到僱員建立過程，這個過程會加入一個索引到僱員工作 的部門。

我們要說明的是如何在DWG檔案中建立C#自訂資料，包括“每個圖形”的C# 自訂資料和“每個實體”的C#自訂資料。“每個圖形”的C#自定 義資料是指只在整個圖形中加入一次的資料，它表示對象可以引用的單一類型或特性。 “每個實體”的C#自訂資料是指是為特定的對象或資料庫中的實體加入的資料 。

在下面的樣本中，我們將加入“每個圖形”的C#自訂資料到命名物件字典( 簡稱NOD)。NOD存在於每一個DWG檔案中。“每個實體”的C#自訂資料加入到一 個名為“擴充字典”的字典（可選）中，它表示每一個僱員。每一個由DBObject 派生的對象都擁有儲存C#自訂資料的擴充字典。而在我們的樣本中將包含這種C#自訂數 據如名字、薪水和部門。

因此這一章的重點是字典對象和擴充記錄（XRecord），它們是我們用來表示C#自訂數 據的容器。

首先讓我們來建立表示公司的條目。在本章的前幾個步驟中，我們將建立如下所示的部門 階層：

◆NOD－命名物件字典

◆ACME_DIVISION－自訂公司字典

◆銷售(Sales) －部門字典

◆部門經理－部門條目

請開啟Lab4檔案夾下的Lab4工程，或接著Lab3的代碼。

< !--[if !supportLists]-->1) < !--[endif]-->我們首先要做的是定義一 個新的函數，它用來在命名物件字典(NOD)中建立公司字典對象。為這個函數取名為 CreateDivision(),，並使用命令屬性來定義CREATEDIVISION命令。

下面是這個函數的代碼，它的形式非常簡單，只是用來在NOD中建立一個ACME_DIVISION（ 用來表示公司）

[CommandMethod("CreateDivision")]
public　void　CreateDivision()
{
Database　db　=　HostApplicationServices.WorkingDatabase;
Transaction　trans　=　db.TransactionManager.StartTransaction();
try
{
//首先，擷取NOD……
DBDictionary　NOD　=　(DBDictionary)trans.GetObject
(db.NamedObjectsDictionaryId,　OpenMode.ForWrite);
//定義一個公司層級的字典
DBDictionary　acmeDict;
try
{
//如果ACME_DIVISION不存在，則轉到catch塊，這裡什麼也不做
acmeDict　=　(DBDictionary)trans.GetObject(NOD.GetAt("ACME_DIVISION"), 　OpenMode.ForRead);
}
catch
{
//如果ACME_DIVISION不存在，則建立它並把它加入到NOD中……
acmeDict　=　new　DBDictionary();
NOD.SetAt("ACME_DIVISION",　acmeDict);
trans.AddNewlyCreatedDBObject(acmeDict,　true);
}
trans.Commit();
}
finally
{
trans.Dispose();
}
}