【導讀】第2頁共22頁。第3頁共22頁。Begin…

　　

【正文】 。= 。 try { do some code } finally 。 版權(quán)所有 169。 Octant Communications Co. Ltd. 保留所有權(quán)利。 第 14 頁 共 22 頁 軟件部項目管理 項目開發(fā)規(guī)范 :代碼編寫要求 。 end。 一個更安全更合適的分配過程應(yīng)是： SomeClass1 := 。 try SomeClass2 := 。 try { do some code } finally 。 end。 finally 。 end。 try… except的使用 只有當在異常被觸發(fā)而你想執(zhí)行一些任務(wù)時才使用 try? except。通常，你沒有必要為了只是簡單地在屏幕上顯示一個錯誤信息而使用 try? except語句，因為這會被 Application 對象自動執(zhí)行。如果你想在 except 子句中執(zhí)行完一些任務(wù)之后調(diào)用缺省的異常處理，使用 raise來重新觸發(fā)異常到下一個句柄。 try… except… else的使用 try? except中的 else子句不建議使用，因為它會打斷所有的異常包括那些你沒有準備的異常。 類類型 命名和格式 類類型的名稱應(yīng)符合使用它們的目的。類型名字應(yīng)加以前綴 T以表明這是一個類型的定義 － 例如： type Tcustomer = class(TObject) 類型的實例通常是沒有前綴 T的類型的名字 － 例如： var Customer :Tcustomer。 注意：查閱“構(gòu)件類型的命名標準”來獲得更多有關(guān)構(gòu)件命名的信息。 域 命名 /格式 類的域名遵循與變量標識符同樣的約定除了它們應(yīng)以 F為前綴，來表明這是一個域的名稱。 版權(quán)所有 169。 Octant Communications Co. Ltd. 保留所有權(quán)利。 第 15 頁 共 22 頁 軟件部項目管理 項目開發(fā)規(guī)范 :代碼編寫要求 可視化 所有的域都必需是私有的。想在類的范圍之外存取域得通過屬性來使用。 方法 命名 /格式 方法的命名應(yīng)遵循本文檔中有關(guān)過程和函數(shù)的約定敘述。 使用靜態(tài)的方法 如果使用一個靜態(tài)的方法，那么該方法就不能被該類的后代類所繼承。 使用虛擬 /動態(tài)的方法 如果你打算該類的方法能被后代的類所繼承就得使用虛擬的方法。只有在該方法有多 個繼承時（直接的或間接的）才使用動態(tài)的方法。例如，一個類類型包含一個可繼承的方法，而 100個后代類要繼承這種方法，那么這個方法就會動態(tài)地產(chǎn)生為 100個后代類使用的內(nèi)存。 使用抽象的方法 如果在一個類中使用抽象的方法，該類就不能被創(chuàng)建。只有在那些永遠不會被創(chuàng)建的類中使用抽象的方法。 屬性存取方法 所有存取類的方法都只能出現(xiàn)在類的 private或 protected部分。屬性存取方法的命名應(yīng)遵循過程和函數(shù)的約定規(guī)則。讀取存取方法（方法讀取器）必需以單詞 Get為前綴。寫入存取方法（方法寫入器）必需以單詞 Set為前綴 。方法寫入器的參數(shù)的名字應(yīng)為 Value，并且它的類型應(yīng)是它所操作的屬性的類型。例如： TSomeClass = class(TObject) private FsomeField : Integer。 protected function GetSomeField : Integer。 procedure SetSomeField(Value : Integer)。 public property SomeField : Integer read GetSomeField write SetSomeField。 end。 屬性 命名 /格式 屬性如果是表示為一個私有域的存取器的話，那么它的名字應(yīng)是它們所操作的域的名字除去解釋符 F。 屬性的名字應(yīng)是名詞，不是動詞。屬性表示的是數(shù)據(jù)，而方法表示的是行為。 數(shù)組類型的名稱應(yīng)為復數(shù)。一般情況下屬性的名稱應(yīng)為單數(shù)。 使用存取的方法 盡管沒有要求，但還是建議盡量少地為一個表示私有域的屬性而使用寫入存取方法。 版權(quán)所有 169。 Octant Communications Co. Ltd. 保留所有權(quán)利。 第 16 頁 共 22 頁 軟件部項目管理 項目開發(fā)規(guī)范 :代碼編寫要求 文件 工程文件 工程文件應(yīng)取個描述性的名字。例如， Delphi 4開發(fā)者指南錯誤管理器 的工程名字是：。一個有關(guān) 系統(tǒng)信息的程序的名字就應(yīng)象 。 窗體文件 一個窗體文件的取名應(yīng)可以描述使用該窗體的目的，并加以后綴 Frm。例如，一個“關(guān)于”的窗體的文件名應(yīng)是 。主窗體的文件名應(yīng)是 。 數(shù)據(jù)模板文件 數(shù)據(jù)模板的取名應(yīng)能表示使用該數(shù)據(jù)模板的目的，它的名稱應(yīng)加以兩個字符的后綴 DM。例如，自定義數(shù)據(jù)模板的文件名字應(yīng)為 。 遠端數(shù)據(jù)模板文件 遠端數(shù)據(jù)模板的取名應(yīng)能表示使用該遠端數(shù)據(jù)模板的目的，它的名稱應(yīng)加以三個字符的后綴 RDM。例如，自定義 遠端數(shù)據(jù)模板的文件名字應(yīng)為 。 Unit文件 通用 Unit結(jié)構(gòu) unit的名字 Unit 文件應(yīng)取一個可描述性的名字。例如，包含應(yīng)用程序主窗體的單元應(yīng)叫做。 uses子句 在 interface 部分的 uses 子句應(yīng)包含在 interface 部分中的代碼所需要的單元。去掉那些Delphi可以自動加入到程序中的單元。 在 implementation 部分的 uses 子句應(yīng)只包含在 implementation 部分中的代碼所需要的單元的名字。去掉不必要的單元。 interface部分 interface部分應(yīng)包含只那些其它單元所需要存取類型的定義、變量、過程 /函數(shù)的預定義等等。否則，就應(yīng)放在 implementation部分定義。 implementation部分 implementation部分應(yīng)包含那些只在本單元中私用的類型定義、變量、過程 /函數(shù)定義等等。 initialization部分 不要在 initialization 部分放入耗時長的代碼，這將使程序的第一個界面出現(xiàn)得比較緩慢。 版權(quán)所有 169。 Octant Communications Co. Ltd. 保留所有權(quán)利。 第 17 頁 共 22 頁 軟件部項目管理 項目開發(fā)規(guī)范 :代碼編寫要求 finalization部分 在這里要保證釋放你在 Initialization部分所分配 的任何資源。 窗體單元 一個窗體的單元文件應(yīng)擁有與它所對應(yīng)的窗體文件同樣的名稱。例如，“關(guān)于”窗體的單元名稱應(yīng)為 ，而主窗體的單元名稱應(yīng)為 。 數(shù)據(jù)模板單元 一個數(shù)據(jù)模板的單元文件應(yīng)擁有與它所對應(yīng)的數(shù)據(jù)模板文件同樣的名稱。例如，一個自定義數(shù)據(jù)模板單元的名稱應(yīng)為 。 一般目的單元 一般目的單元的取名應(yīng)符合使用該單元的目的。例如，一個實用程序單元取名為。一個包含全局變量的單元取名為 。 注意，該單元的名字不能與它的工程中所使用的所有包中的單元的名字相同。不贊成使用一般的或通用的單元名字。 構(gòu)件單元 構(gòu)件單元應(yīng)放在獨立的目錄，以將它們同定義構(gòu)件組或構(gòu)件集合的單元區(qū)分開來。它們要永遠同工程在不同的目錄。單元名字應(yīng)同它們的內(nèi)容相符。注意：查閱“用戶定義的構(gòu)件”部分來獲得更多有關(guān)構(gòu)件命名標準的信息。 窗體和數(shù)據(jù)模板 窗體 窗體類型命名標準 窗體類型的取名應(yīng)能表達使用該窗體的目的。類型定義應(yīng)加以前綴 T。前綴后面跟隨著描述性的名字。最后，應(yīng)加以 Form 后綴來描述名字。例如，一個“關(guān)于”的 窗體的類型的名字應(yīng)為： TAboutFrom = class(TForm)。 主窗體的定義為： TMainForm = class(TForm)。 一個用戶接入窗體的名字應(yīng)象： TCustomerEntryForm = class(TForm)。 窗體實例命名標準 窗體實例應(yīng)是沒有帶前綴 T的相應(yīng)類的名字。例如，對應(yīng)于前面窗體類型而言，其實例的名字應(yīng)為： 類型名稱 實例名稱 TAboutForm AboutForm 版權(quán)所有 169。 Octant Communications Co. Ltd. 保留所有權(quán)利。 第 18 頁 共 22 頁 軟件部項目管理 項目開發(fā)規(guī)范 :代碼編寫要求 TMainForm MainForm TCustomerEntryForm CustomerEntryForm 自動創(chuàng)建窗體 只有主窗體可以是自動創(chuàng)建的除非有其它更好的理由不這樣做。所有其它的窗體必需從工程選項對話框中的自動創(chuàng)建列表中移走。查閱以下部分來獲得更多的信息。 模式窗體實例化函數(shù) 所有的窗體單元都應(yīng)包含一個窗體實例化函數(shù)，該函數(shù)用來創(chuàng)建、設(shè)置、模式地顯示窗體，并釋放窗體。該函數(shù)應(yīng)返回窗體的模式結(jié)果。該函數(shù)要傳遞的參數(shù)應(yīng)遵循本文檔指定的“參數(shù)傳遞”標準。通過這種方式封裝的函數(shù) 性有助于代碼的再利用和維護。 該窗體的變量要從單元中移走，并再窗體實例的函數(shù)中進行本地式地定義。注意，這就意味著該窗體必需從工程 /選項對話框中的自動創(chuàng)建列表中剔除。參考本文檔后面的“自動創(chuàng)建窗體”。 例如，下面的單元展示了再 GetUserData窗體中的一個函數(shù)。 unit UserDataFrm。 interface uses windows, Messages, SysUtils, Classes, Graphics, Controls, Forms, Dialogs, StdCtrls。 type TUserDataForm = class(TForm) edtUserName : TEdit。 edtUserID : TEdit。 private { Private declarations } public { Public declarations } end。 function GetUserData(var aUserName ： String。 var aUserID : Integer) : Word。 implementation {$R *.DFM } function GetUserData(var aUserName : String。 var aUserID : Integer) : word。 var UserDataForm : TuserDataForm。 begin UserDataForm := (Application)。 try := ‘Getting User Data’。 Result := 。 if (Result = mrOK) then 版權(quán)所有 169。 Octant Communications Co. Ltd. 保留所有權(quán)利。 第 19 頁 共 22 頁 軟件部項目管理 項目開發(fā)規(guī)范 :代碼編寫要求 begin aUserName := 。 aUserID := StrToInt()。 end。 finally 。 end。 end。 end. 數(shù)據(jù)模板 數(shù)據(jù)模板命名標準 數(shù)據(jù)模板的取名要符合使用該數(shù)據(jù)模板的目的。類型的定義應(yīng)加以前綴 T，后面緊接著描述性的名字，最后要加以后綴單詞“ DataModule”。例如，一個自定義的數(shù)據(jù)模板有時候應(yīng)該象： TCustomerDataModule = class(TDataModule) 一個命令式的數(shù)據(jù)模板的名字應(yīng)象： TOrdersDataModule = class(TDataModule) 數(shù)據(jù)模板實例命名標準 數(shù)據(jù)模板實例的名稱應(yīng)是對應(yīng)不帶前綴 T的類型的 名稱。例如，對于前面的窗體類型而言，其實例的名稱應(yīng)為： 類型名稱 實例名稱 TCustomerDataModule CustomerDataModule TOrdersDataModule OrdersDataModule 包 使用運行包和設(shè)計包的比較 運行時刻的包應(yīng)只包含其它構(gòu)件包所要求的單元或構(gòu)件。另外，包含屬性 /構(gòu)件編輯器和其它只為設(shè)計的代碼應(yīng)放入到設(shè)計時刻包中。注冊單元應(yīng)放在設(shè)計包中。 文件命名標準 包的名稱應(yīng)依照下面的例子 ： “ ” － 設(shè)計時刻包 “ ” － 運行時刻