命名原則
- 前綴 + 有意義名稱:如
txtUserName、btnSubmit、gvOrderList
- 前綴統一小寫,名稱使用 PascalCase
- 避免使用預設名稱 (
TextBox1、Button2)
常用控制項前綴對照表
| 控制項類型 | 前綴 | 範例 |
| Label | lbl | lblUserName |
| TextBox | txt | txtPassword |
| Button | btn | btnLogin |
| LinkButton | lnkbtn | lnkbtnForgotPwd |
| ImageButton | imgbtn | imgbtnSearch |
| ListBox | lst | lstCategories |
| DropDownList | ddl | ddlCountry |
| DataGrid (舊) | dg | dgProducts |
| DataList | dl | dlNews |
| CheckBox | chk | chkAgree |
| RadioButton | rdo | rdoMale |
| RadioButtonList | rdolst | rdolstGender |
| Image | img | imgPhoto |
| Panel | pnl | pnlContainer |
| Calendar | cal | calBirthDate |
| AdRotator | ar | arBanner |
| MenuStrip | ms | msMain |
| ToolStripMenuItem | tsmi | tsmiFileNew |
| PictureBox | pic | picAvatar |
| StatusStrip | ss | ssStatusBar |
| DataGridView | dgv | dgvOrderDetails |
| Table | tbl | tblLayout |
| RequiredFieldValidator | rfv | rfvEmail |
| CompareValidator | cv | cvConfirmPwd |
| RangeValidator | rv | rvAge |
| RegularExpressionValidator | rev | revEmailFormat |
| ValidationSummary | vs | vsFormSummary |
| CrystalReportViewer | rptvew | rptvewSales |
| ComboBox | cbo | cboCity |
| GroupBox | grp | grpPersonalInfo |
| ImageList | il | ilToolbar |
| ListView | lv | lvFileList |
| ColumnHeader | ch | chFileName |
| StatusLabel | slbl | slblConnection |
| TabControl | tab | tabMain |
| TabPage | tp | tpSettings |
| Timer | tmr | tmrAutoSave |
| ToolStrip | ts | tsToolbar |
| ToolStripButton | tsbtn | tsbtnSave |
| ToolStripDropDownButton | tsddb | tsddbOptions |
| DomainUpDown | dud | dudQuantity |
| FileUpload | ful | fulAttachment |
| Repeater | rpt | rptComments |
進階命名建議
- 分組前綴:同一功能區塊加共同前綴,如
pnlLogin_txtUserName、pnlLogin_btnSubmit
- 狀態後綴:區分唯讀/編輯模式,如
txtUserNameView、txtUserNameEdit
- 避免縮寫歧義:
btnDel vs btnDelete,建議完整拼寫
- 配合 ReSharper/EditorConfig:強制團隊遵循命名規則
快速參考卡 (列印版)
Web 常用: lbl txt btn lnkbtn imgbtn lst ddl dg dl chk rdo rdolst img pnl cal
驗證: rfv cv rv rev vs
資料: dgv gv(GridView) rpt lv
容器: pnl grp tab tp
選單: ms ts tsmi tsbtn tsddb
其他: pic cbo il ch slbl tmr ful