【设计原则和建议】 方法
方法
1.一个方法内的代码不能超过30行.
- 绝大部分方法都可以在30行内结束.
- 这是一种强迫开发者优化设计和代码的方式.
- 静态构造函数,抛出以后整个类型就再也无法使用了.
- 构析函数.
- 属性的get方法 (有些类的设计会违背这个特性).
- Dispose (理论上也不应该抛出异常,不过有些设计已经抛出了异常).
3.还没有实现的方法应该抛出NotImplementedException 异常.
4.移除没有被调用到的方法 .
5.方法命名推荐Pascal命名.
- 推荐动词+名词方式 例如 GetUser, DisableUser
- 如果在类的实例方法上,推荐动词做方法名 例如User.Create
静态方法和实例方法
1.静态方法应该是线程安全的
- 调用方使用静态方法(如Console.Write),调用方会预期静态方法是线程安全的
public static Dictionary<string, object> dict = new Dictionary<string, object>();
public static ConcurrentDictionary<string, object> concurrentDict = new ConcurrentDictionary<string, object>();
public static void Test1()
{
if (!dict.ContainsKey("key"))//线程不安全
{
dict["key"] = "value";
}
}
public static void Test2()
{
concurrentDict["key"] = "value";//线程安全,
}
2.如果一个方法没有使用到this,那么考虑声明为静态方法
3.基本类库和常用方法优先设计为静态方法 (如Log.Error SqlHelper.Execute)
4.为什么选择静态方法
- 容易实现面向过程的编程
- 静态方法调用较为简单,少了一个new的过程
- 如果希望设计一个较为独立的方法(和类中的其他对象关系较少),静态方法是一个较好的选择 ,静态方法往往更容易移植
- 性能较好
1.不需要在运行时判断多态 (没有继承链的问题)
2.调用静态方法不需要传递实例对象指针
3.实例方法需要至少new一个对象, 有GC的压力
5.为什么选择实例方法
- 和面向对象的设计结合较好
- 借助多态等,功能比静态方法要强大
方法可访问性
1.在声明方法的时候显式声明可访问性, 不要使用默认值,以免不熟悉默认访问性的开发者搞错了
2.保持最低的可访问性, 例如能private的就不要public
- 避免第三方错误调用了不应该public的方法
- 避免第三方引用了public方法以后,在重构时无法移除该方法
3. 使用new关键字复写父类方法 , 一般要保持同级或者较高的可访问性
public class ClassA
{
public virtual void Test()
{
}
}
public class ClassC : ClassA
{
protected new void Test() //bad
{
}
}
方法继承
1.如果想重写父类的方法,一定要用new关键字显式覆盖,以免非预期的重写
public class ClassA
{
public void Test()
{
}
}
public class ClassB : ClassA
{
public new void Test()//good
{
}
}
public class ClassC : ClassA
{
public void Test() //bad
{
}
}
2.某些方法需要一起被override, 例如 IComparable.CompareTo 和 Equals , 又例如重写运算符的时候 = 和 !=
3.只在希望子类override方法实现的时候使用virtual关键字
4.不要在构造函数中调用虚方法
- 调用虚方法时,直到运行时之前都不会选择执行该方法的实际类型。 构造函数调用虚方法时,可能尚未执行调用该方法的实例的构造函数。
5.如果是实现了Dispose方法,那么在该方法体内,请调用父类的Dispose方法
对比
1.和属性对比
- 属性返回值相对静态,所以DateTime.Now是一个不好的设计(因为Now的值会一直变化)
- 方法返回值相对动态,所以Guid.NewGuid()是一个好的设计
部分内容引用自MSDN,FxCop 和其他第三方文章..
因为本人水平有限,如有遗漏或谬误,还请各位高手指正
【推荐】国内首个AI IDE,深度理解中文开发场景,立即下载体验Trae
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· Linux系列:如何用 C#调用 C方法造成内存泄露
· AI与.NET技术实操系列(二):开始使用ML.NET
· 记一次.NET内存居高不下排查解决与启示
· 探究高空视频全景AR技术的实现原理
· 理解Rust引用及其生命周期标识(上)
· 物流快递公司核心技术能力-地址解析分单基础技术分享
· .NET 10首个预览版发布:重大改进与新特性概览!
· 单线程的Redis速度为什么快?
· 展开说说关于C#中ORM框架的用法!
· Pantheons:用 TypeScript 打造主流大模型对话的一站式集成库