NETS編碼規則株式會社東芝（注）：頁開始是英文文資料。NOTE :The prvious page is the Japanese Documentations . The English ones Starts from this page .資料號碼：.第 1 章 序言4第 2 章 編碼的準備5第 3章 命名規約63 1 . 使用的目的63 2 . Object的結構化733. 前綴（prefix）83 4 . 標簽（tag）93 5 . 基本名（BaseName）103 6 . 量詞（ Qualifier）113 7 . 后綴（Suffix）12第章模塊頭134 1 . 外部模塊頭134 2 . 內部模塊頭154 3 . 注釋語句17第 5章 錯誤處理195 1 . 結構化錯誤處理195 2 . Inline錯誤處理19第 6章 編碼規約206 1 . 函數化206 2 . 常數的使用206 3 . 變量的聲明206 3 1 . 變量生明206 3 2 . 變量的范圍226 4 . 函數的聲明226 4 1.SUB226 4 2 . FUNC226 5 . 控制語句226 5 1 . I FENDIF225 5 2. FORNEXT245 5 3.SELECTCASE255 5 4.DO LOOP27第 7 章 控件28第章用戶控件29.在用戶控件上作成規定屬性298 2 . 在用戶控件中作成規定Event30第章數據庫訪問規則31開發環境31連接斷開31表示檢索的結果33第 1 章 序言所謂編碼就是基于在程序設計時作成的程序設計書和流程圖等邏輯設計、用編程語言、對為在計算機上實現某些功能的邏輯進行描述的工作。在編碼過程中、為了消除因程序員水平不同而造成的差異、為了順利的進入單體測試階段、同時也為了維護方便、以下整理了編碼的準備和代碼書寫的標準。而且、關于書寫標準、除非客戶有指定的要求、或者使用了（半）自動生成代碼的工具話、則應盡量遵從這個標準。本規范是以使用Microsoft 的 Visual Basic 來開發PC的應用程序為前提的。第 2 章 編碼的準備（1） 以系統設計書、程序設計書（根據情況也包含流程圖等的邏輯設計書）為基礎。（2） 在完全理解了以上文檔內容的基礎上開始編碼工作（特別是程序設計書的作者和編碼的擔當者不同時）。對于不明白的地方不要隨意判斷、要進行確認。（3） 始終注意要把程序的易理解性（易讀性）放在第一位。為此、在編程時要時刻想著程序的讀者、本著以向讀者說明的態度來編寫程序是寫好程序的關鍵。讀起來容易理解的程序一般來說總是質量優良、而且容易改造的。（4） 象數據庫的記錄的規范等include文件、模塊頭、宏定義等系統應該統一的東西、要采用系統規定的東西、不要根據個人的意愿隨意的作成、否則、這將成為在進行變更和改造時發生問題的原因。（5） 編碼結束后、要對代碼進行檢查。不檢查代碼則不能輕易的進入下一步的測試階段的工作。檢查代碼不僅是最容易發現錯誤的方法、而且有時還能檢出在測試時不易發現的復雜錯誤。第 3章 命名規約3 1 . 使用的目的命名規約以以下4點為目的的而使用。（1） Object名容易明白會使應用程序的結構代碼等容易理解。（2） 確立開發小組“通用語言”、使全體成員用同樣的“語言”來開發應用程序。（3） 使VB Jet的Object 容易被使用。（4） 用較少的勞力作成VB開發用的工具、在各式各樣的VBA 平臺里通用的源碼庫。本規約是用遵從被VisualBasic作為標準的 Lezynski命名規則（Lezynski Naming Convention、 以下稱LNC）的方法來規定命名法的。3 2 . Object的結構化LNC按以下格式對Object進行命名。 Prefix tag BaseName Quantifier Suffix Prefix前綴Tag標簽BaseName基本名Quantifier量詞Suffix后綴對各個部分按順序進行說明。. 前綴（prefix）前綴是在標簽前面的識別符、是對標簽進行進一步詳細說明的。前綴用1到2個小寫字母組成。對1個Object復數個前綴可以組合使用。前綴有表示有效范圍的和表示變量特性的。另外、2個前綴能夠重疊使用。（1） 表示有效范圍的前綴表1 . 表示有效范圍的前綴無Procedure內的局部變量s用Static聲明的Procedure的局部變量m在模塊Declarations Section 的用Dim 或Private聲明的模塊水平的變量p在模塊的Declarations Section用Public聲明的變量g在模塊的Declarations Section作為Public或Global聲明的變量（2） 表示變量特性的前綴表2. 表示變量特性的前綴a作為數組聲明的變量c用Const聲明的變量e作為的Collection1個要素的變量i作為數組的Index或循環的計數器使用的變量r傳遞給Procedure參數的作為參照傳遞( ByRef )聲明的變量t作為用戶定義型定義的變量v傳遞給Procedure參數的作為值傳遞( ByVal )聲明的變量（3） 例值傳遞的參數：vintCount參照傳遞的參數： rstrFileName在Declarations用public聲明的數組的Index變量：apintMember用Const聲明的變量：cintFNAMEMAX3 4 . 標簽（tag）標簽是表示基本名的特征的復數個的字母、放在基本名的前面。標簽基本上相當于面向Object編程的類識別符。標簽用3到4個小寫字母組成。標簽是表示基本名的特征的復數個的字母、表示變量的型啦的種類。從標簽表示的意思上可以對數據型、模塊、Form、控件的標簽進行分類。（1） 數據型表3. 數據型標簽布爾值bln長整數lngBytebytObjectobj雙精度浮點數dbl字符串str錯誤err用戶定義typ整數intVariantvar（2） 模塊、Form、控件表4 模塊標簽 表5. 標簽類模塊cls對話框fdlg標準模塊bas菜單fmnuFormfrm表6. 控件標簽Command ButtoncmdOption Buttonopt控件ctlPocturepic,picsCombo BoxcboPrinterprn,prns菜單mnu屬性prp,prps菜單項mni,mnisTabtab,tabsNodenod,modsText BoxtxtList BoxlstCommon Dialogcdlg（3） 例l 判定成功用的變量：blnSuccessl 文件名：strFileNamel 檢索處理用的標準模塊：basSearchDatal 主Form：frmMainl Start Button：cmdStartl Font Dialog：cdlgFont3 5 . 基本名（BaseName）基本名是設Object名是最先遇到的部分、是不管采用不采用命名規則都必須使用的名字。基本名要用有意義的單詞（原則上用英文單詞）來組合、各個單詞的第一個字母大寫其余用小寫。這時、再加上專用名詞的情況下、要用日語的羅馬字。但是、用Const聲明的變量的基本名全部用大寫。另外、雖然沒有限制、基本名還是要選擇不太長的名字。作為基本名的樣本用在VB編碼里的標準的作業變量表示如下。表7 . 標準LNC作業變量blnRET接受函數調用的返回值（ True/False ）intErr保持Err的值intLoop循環計數器intMsg接受MsgBox函數的返回值intResult保持算術演算的接果（dblresult 、lngResult 也同樣）intRet接受函數調用的返回值（dblRet、lngRet也同樣）intWord用在所有暫時的作業（dblWord 、 lngWork也同樣）strMsg作成Message Box字符串3 6 . 量詞（ Qualifier）量詞表示Object在關聯上是怎樣被利用的。（最大、最小等）量詞要盡量短、用大寫.小寫字母的組合來表示。表8 . 量詞Curr存貯1Set內的現在的要素First存貯1Set內的最初的要素Hold存貯以后要使用的要素Last存貯1Set內的最后的要素Max存貯1Set內的最大要素Min存貯1Set內的最小要素Next存貯1Set內的下一個的要素New存貯的新的instance或值Oid存貯的以前的instance或值Prev存貯1Set內的前面的要素Src存貯SourceTemp存貯暫時的值3 7 . 后綴（Suffix）后綴是以在按照命名規則時變成的名字的Object名上識別符為目的而添加的。所以不是非要不可、根據Project決定是否采用。假設DB關聯的標準模塊有SortData、DeleteData、InsertData、UpdateData4個。這時、如果存貯錯誤碼的變量設為、在各個模塊里確保變量的話、就會區別不開。如果在取各個模塊的大寫的2個字母作后綴、各個變量就能區別開。SortData（ SD ）-gintErr_SDDeleteData（ DD ）-gintErr_DDDeleteData（ ID ）-gintErr_IDDeleteData（ UD ）-gintErr_UD雖然后綴的決定方法沒有特別的基準、還是要選擇容易明白區別基準的2到3個字母的字符串。另外、大寫字母、小寫字母可以任意使用。第章模塊頭 模塊頭對了解模塊的概要是很有效的、另外還有助于維護。所以、對此必須記述。4 1 . 外部模塊頭外部模塊頭要記述以下項目。（有關程序全體的信息在Include文件（文件名=程序名.h）記述。）（ a ）模塊識別信息 系統名 客戶名 程序名或模塊名 擔當部科名 著作權表示（ b ） 模塊說明 功能 參數說明 動作環境/作成環境 作成擔當著名（ c ） 履歷 作成日時（單體試驗完成日） 變更日時 變更內容 版本信息（ d ）補充說明 外部模塊頭*Copyright Shenyang NETS System Integration Co. Ltd.1998.All Rights Reserved.系統名 ：系統名客戶 ：客戶 程序 ：程序名稱擔當部長 ：沈陽東東系統集成有限公司 開發一部*功能 ：功能概要參數 ：對有關重要參數進行說明作成環境 ：工具、編譯環境、OS動作環境 ：OS、制約條件擔當 ：擔當者名作成日 ：1999年5月28日 （Ver.0）*變更履歷 Ver.0.1 1999年5月28日 所屬 擔當者名 變更理由 變更內容Ver.1.0 1999年6月15日 所屬 擔當者名 變更理由 變更內容*/4 2 . 內部模塊頭在內部模塊頭寫下以下項目。 （ a ）模塊說明 功能 參數說明 動作環境/作成環境 作成擔當者名 （ b ）履歷 作成日時（單體試驗完成日） 變更日時 變更內容 版本信息（c ）補充說明 內部模塊頭*功能 ：功能概要參數 ：對有關參數進行說明擔當 ：擔當者名作成日 ：1999年5月28日（Ver .0）*變更履歷Ver .0 1999年5月31日 所屬 擔當者名 變更理由. 變更內容Ver .0 1999年6月15日 所屬 擔當者名 變更理由. 變更內容*4 3 . 注釋語句1. 考慮到提高維護性、以模塊及塊為單位寫上內容說明、以便馬上能找到修改的地方。2. 為了幫助讀者理解程序、在不容易理解的邏輯上加上說明。不是在只讀了程序馬上就能理解的地方加上注釋、而是要象給讀者提供新信息之類的說明。例如、寫上在那里使用的算法的注釋。3. 不要加上不必要的注釋。在注釋之前、先要在識別符命名法、整理程序構造上下工夫使程序容易被讀懂。4. 注釋語句盡可能寫的簡單明了.5. 注釋寫在語句的前面時要和語句的列對齊。 注釋 XXXX YYYY6. 把源碼刪除、改成注釋時、不要用不容易弄清范圍是否有效的寫法。 Ver0.5 刪除 start XXXXX； YYYYY； Ver0.5 刪除 end. 變更 修改程序時對注釋也必須進行維護。第 5章 錯誤處理錯誤處理有“結構化錯誤處理”和“Inline錯誤處理”2種方法。現在的主流雖然是“結構化錯誤處理”、根據系統也可以使用“Inline錯誤處理”。另外、也可以把兩個組合起來使用。但是、必須對所有的錯誤的發生都執行錯誤處理來進行編碼。5 1 . 結構化錯誤處理結構化錯誤處理是以“On Error Goto XXXX”的語句來記述、在XXXX的部分記述錯誤處理的方法。這時、錯誤處理程序XXXX原則上寫在Procedure的最后、XXXX要設成、“錯誤名”+“Err”的名字。5 2 . Inline錯誤處理Inline錯誤處理是在錯誤發生后馬上Trap錯誤的編碼方法。為了實行這個、實施以下2點。 在Procedure的開始處寫上“On Error Resume Next”語句 在有可能發生錯誤的碼的緊后面編進確認邏輯。第 6章 編碼規約6 1 . 函數化 在符合以下條件的情況下、要把處理匯總成子成序。 2個地方以上被使用的處理 超過100步的處理獨自作成的函數要寫在BAS文件里。這時、BAS文件的最大步數不要超過500步。關于被2個以上可執行文件使用的函數、共享包含那個函數的BAS文件。6 2 . 常數的使用關于字符串的尺寸、上限值、下限值等預先定下來的值、要把這個作為文字常數來定義并使用此常數。6 3 . 變量的聲明 6 3 1 . 變量聲明（ 1 ）“Option Explicit”生明Option Explicit”聲明使聲明所有的變量在參照前必須進行聲明的聲明。在作成新模塊時、必須進行這個聲明。或在環境中設置。（ 2 ） “Dim”聲明Dim”聲明是為了聲明變量并分配存貯領域而使用。因為聲明因生明的地方不同而使范圍不同、所以如果希望范圍明確的話、用“Public”、“Private”聲明進行聲明。用“Dim”聲明進行變量聲明時、必須把變量的型用“As Type ”來聲明這時、在進行復數個變量聲明的情況下、要給各個變量加上“As Type”。例）Dim strName As String , strFile As String ,strData As String 這種情況下、String型的str Name str File, str Data 3個變量被生明。Dim strName , strFile ,strData As String 這種情況下、Variant型的s z Name 、s z File 和String 型的s z Data 變量被聲明。 （ 3 ）“Public 、Private”聲明這些聲明是在對水平的變量進行聲明時使用。“Public”是對Project內通用的變量、“Private”是只對模塊內使用的變量使用。（ 4 ）“Static” 聲明在對Procedure水平的變量進行聲明時使用。用“Static”聲明的變量在程序執行期間內成為有效的變量。（ 5 ）“Const”聲明 Procedure模塊兩方多可使用。用“Const”聲明的變量不能變更。用“Public” “ Static” “ Const”聲明的變量要預先記載在設計書上。另外、盡可能地把這些變量匯總在1個標準模塊上聲明。6 3 2 . 變量的范圍變量由于聲明的地方和聲明的種類不同有效范圍會有所不同、所以要在考慮范圍后再對變量進行聲明。6 4 . 函數及子程序的聲明函數的聲明參數“ByRef” “ByVal”的聲明必須進行。讀入在DLL定義的函數時、要對被DLL Export的函數名確認后在進行聲明。用Alias變更函數名時、要用容易明白原來的函數名的名字。6 4 1.SUB調用子程序時、有用和不用Call調用的方法、在系統中要統一。6 4 2 . FUNC 聲明函數時、要用As Type的形式對返回值進行聲明。6 5 . 控制語句6 5 1 . I FENDIF有關條件比較、必須考慮進ELSE進行記述。原則上要用肯定型條件比較。進行變量比較時、原則上不使用神秘數用全局變量或常數進行比較。例） if nCount = MAX-COUNT then nPage = nPage + 1 endif if nCount = 10 then nPage = nPage + 1 endif5 5 2. FORNEXT把循環變量寫在 NEXT 的后面使循環的范圍容易明白例） For nLoop = 1 to 100 nPage = nPage + 1 NEXT nLoop For nLoop = 1 to 100 nPage = nPage + 1 NEXT 5 5 3.SELECTCASE關于語句的各個值的意義要寫上注釋。另外、考慮到取得預期以外的值的情況要加進CASE ELSE 語句。SELECT CAES 語句嵌套時、要寫上注釋使對應的End Select容易被明白。例） Select MSG Case 1 “Yes”的情況 nPage = nPage + 1 Case 2 “