C#事件標準命名規(guī)則

一些開源代碼的事件命名很混亂，以此文章用作本人以后工作的參考。

事件的名稱

事件始終是指某個操作，這個操作可能正在發(fā)生，也可能已經(jīng)發(fā)生。 因此與方法一樣，事件用謂詞命名，謂詞時態(tài)用于指示事件引發(fā)的時間。

? 務必使用謂詞或謂詞短語來命名事件。

示例：Clicked、Painting、DroppedDown 等。

? 務必通過使用現(xiàn)在時態(tài)和過去時態(tài)，讓事件名稱含有時間先后的概念。

例如，窗口關閉之前引發(fā)的事件稱為 Closing，窗口關閉之后引發(fā)的事件稱為 Closed。

X 請勿使用 “Before” 或 “After” 前綴和后綴來指示事件之前或之后。 應按前述使用現(xiàn)在時態(tài)和過去時態(tài)。

? 請使用 “EventHandler” 后綴來命名事件處理程序（用作事件類型的委托），如以下示例所示：

public delegate void ClickedEventHandler(object sender, ClickedEventArgs e);

? 務必在事件處理程序中使用兩個名為 sender 和 e 的參數(shù)。

sender 參數(shù)表示引發(fā)事件的對象。 sender 參數(shù)的類型通常是 object，且可能會使用更具體的類型。

? 務必使用“EventArgs”后綴來命名事件參數(shù)類。

個人建議：對于名稱意義不明的事件可添加Event后綴，盡量少用后綴。

官方參考：https://docs.microsoft.com/zh-cn/dotnet/standard/design-guidelines/names-of-type-members#names-of-events

事件觸發(fā)方法的名稱

事件需要有一個事件觸發(fā)方法，用于檢測事件是否有綁定的方法，如果有就觸發(fā)事件。直接觸發(fā)事件在事件沒有綁定方法時會引發(fā)空異常。

? 務必使用“On+事件名稱”來命名事件觸發(fā)方法。

C#命名規(guī)范、變量、類Class

C#中的命名規(guī)范

1、命名方式

駝峰命名法：變量命名時，首單詞全部小寫，之后單詞首字母大寫。適用于變量的聲明

例如：int imgIndex=0;  string txtPersonName="xxx";

帕斯卡命名法：所有單詞的首字母大寫。適用于所有的項目名稱、對象名稱、方法名稱、屬性名稱

例如：Class BigCar,SmallCar;

2、命名規(guī)則

《1.》 創(chuàng)建項目在學習過程中可以使用中文，但是在工作中嚴格禁止使用中文、拼音

《2.》 在給項目命名使用帕斯卡命名法(所有的英文單詞首字母大寫)

《3.》 聲明變量等不允許使用特殊符號(除過_)、關鍵字

什么是變量

變量是指在程序執(zhí)行時，將一些數(shù)據(jù)要進行臨時存儲，隨著程序的執(zhí)行過程隨時隨地需要被使用，這時需要在程序的運行內(nèi)存中開辟一個空間來臨時存放這些數(shù)據(jù)，這就是變量的作用

1、如何聲明變量

• [訪問修飾符] 數(shù)據(jù)類型 變量名稱=初始值;
• 數(shù)據(jù)類型（值類型和引用類型）：規(guī)范了這個變量空間中允許存放的數(shù)據(jù)的類型
• 變量名稱：可以理解為變量的指針地址，可以通過變量名稱來尋找變量中所存放的數(shù)據(jù)
• 初始值：當這個變量被定義時初次所存儲的數(shù)據(jù)

2、變量的分類

《1.》 全局變量

• 全局變量是指一個變量的聲明地方直接在Class里面，
• 全局變量聲明周期：從計算機開始創(chuàng)建這個Class對象則全局變量就被創(chuàng)建，到這個Class對象被GC釋放全局變量也被清理
• 變量的作用域：在這個Class內(nèi)部的任何地方都可以被使用

《2.》局部變量

• 局部變量是指一個變量的聲明地方在類成員中(方法、事件、語法結構中)
• 局部變量的聲明周期：計算機閱讀到變量的聲明代碼則變量被創(chuàng)建，到計算機閱讀超出變量的作用域變量被釋放
• 變量的作用域：在其聲明地所在的大括號內(nèi)部
• 盡可能減少不必要的全局變量，能用局部變量解決的問題千萬不要使用全局變量，在一個對象中的任意地方都有可能用到這個變量時，才聲明為全局變量

類Class

1、類是什么

• 類指的是一類對象的統(tǒng)稱，類也是對象，類是對象的抽象化
• 在編程中創(chuàng)建對象，寫出的代碼叫類

2、類如何識別

• 關鍵字顏色是淡綠色
• 要么就觀察其類型是Class

3、類如何使用

• 大多數(shù)類在使用時，需要先對其進行實例化創(chuàng)建一個新的成員對象，這個對象就具有這個類的所有功能
• 實例化的最終結果是產(chǎn)生一個這個類型的新對象成員

總結

以上為個人經(jīng)驗，希望能給大家一個參考，也希望大家多多支持腳本之家。

最新評論