文章目录
C# 命名规范
使用Pascal case
在命名类、结构、方法、属性或常量字段时,通常首选Pascal大小写
namespace ExampleApp
{
class ClassNamingConvention
{
public const string ConstantFieldNamingConvention = "C#";
public string PropertiesNamingConvention { get; set; }
public void MethodNamingConvention()
{
//type something here
}
}
}
命名接口时,它通常以大写字母I作为前缀。命名接口时也可以使用Pascal大小写。
public interface IInterfaceNamingConvention
{
//type something here
}
使用Camel case
驼峰用于命名方法参数、私有字段和局部变量。私有字段通常以_作为前缀。
private string _fieldsNamingConvention;
public void MethodNamingConvention(string methodArgsNamingConvention)
{
string localVariables = "string here ...";
}
方法、属性、类命名见名知义
始终为类、方法和属性使用有意义且不言自明的名称。用它们的作用来命名属性、方法和类是一种很好的做法。这样,只需阅读名称,你就可以很容易地知道它的确切作用。
class AppNotification
{
private string _appStatus;
public string AppStatus
{
get { return _appStatus; }
set { _appStatus = value; }
}
public static void SendNotification()
{
//type something here . . .
}
}
LINQ查询变量使用有意义的名称
始终为LINQ查询变量使用有意义且不言自明的名称,如下例所示。
public void QueryRacers()
{
var racersInItaly = from racer in racers
where racer.City == "Lazio"
select racer.Name;
}
C# Code Layouts and Comments
如何声明成员变量和字段
始终在类的顶部声明所有成员变量和字段。当在类的顶部声明字段时,很容易看到类正在使用的所有变量,并理解类的整体状态。
在C#中,在类的顶部声明字段也很重要,因为它使代码更有组织性和可读性,特别是在处理大型类或与团队合作时。这使得其他人更容易理解代码并进行更改。
class Car
{
private int _carSpeed;
public int CarSpeed
{
get { return _carSpeed; }
set { _carSpeed = value; }
}
public static void GetMaxSpeed()
{
//...
}
public static void GetMaxAcceleration()
{
//...
}
}
正确格式化和缩进代码
当涉及到代码布局时,为了可读性和清晰的代码组织,格式化和正确缩进代码非常重要。
每行只写一条语句是很好的做法。例如:
public void Numbers(int number)
{
//Good practice
if (number > 0)
{
Console.WriteLine(number);
}
//Bad practice
if (
number
< 0
)
{
Console.WriteLine(number);
}
}
如何撰写备注
最好的做法是以大写文本开始注释,并以句点结束。(英文注释)
写评论对整个团队都有帮助。它使代码更具可读性、可维护性和可理解性。将注释放在新行上,而不是放在代码末尾,这是一种很好的做法。例如:
class Car
{
public string Name { get; set; }
//We place comments here.
//And end with a period.
public void Move()
{
//...
}
}
通用C#编码最佳实践
如何将值与空字符串进行比较
在将值与空字符串进行比较时,请尝试String.Empty而不是“”。使用String.Empty可以提高代码的可读性,并明确表示比较是针对空字符串的。这使得将来更容易理解和维护代码。
public void NameCheck(string name)
{
if(name == String.Empty)
{
}
}
使用异常处理
使用异常处理来优雅地处理错误和异常。这有助于防止代码崩溃,并使其更加健壮。对于大多数异常处理,使用try-catch语句是很好的做法。
public void NameCheck(string name)
{
try
{
//type code here
}
catch (Exception exception) { }
{
//type code here
}
}
使用&&和||可获得更好的性能
为了提高应用程序的性能,在执行比较时最好使用&&而不是&,使用||而不是|,如下例所示。
public void Numbers(int number)
{
if (number > 2 && number < 4)
{
Console.WriteLine(number);
}
}
这是因为&&和||运算符被称为“短路”运算符。这意味着,如果&&运算的第一个操作数为false,则不会计算第二个操作数,因为整个表达式必须为false。
同样,如果||操作的第一个操作数为真,则不会计算第二个操作数,因为整个表达式必须为真。
这反过来又提高了程序的性能。
单一职责
最好将方法限制为单个功能。不要试图将一个类的多个功能组合到一个方法中。这确保了代码的可读性,并帮助您避免编写“意大利面条式代码”。
class AppNotification
{
public void SendNotification()
{
//. . .
}
public void ReceiveNotification()
{
//. . .
}
public void MuteNotification()
{
//. . .
}
}
使用枚举表示离散值
使用枚举而不是数字和字符串来表示离散值。枚举提供了一种提高代码质量的方法,使其更具可读性、类型安全性和效率。它们还提供了一种定义一组命名积分常数的方法。
class Car
{
public enum LoggerType
{
NewCars,
UsedCars,
Database
}
public void DisplayException(string message, LoggerType loggerType)
{
switch (loggerType)
{
case LoggerType.NewCars:
Console.WriteLine(LoggerType.NewCars);
break;
case LoggerType.UsedCars:
Console.WriteLine(LoggerType.UsedCars);
break;
case LoggerType.Database:
Console.WriteLine(LoggerType.Database);
break;
default:
Console.WriteLine(message);
break;
}
}
}
如何将字符串变量与用户输入进行比较
在将字符串变量与用户输入进行比较之前,始终将其转换为大写或小写是一种很好的做法。
这确保了比较不区分大小写。这使您的代码更具可读性和可维护性,因为它消除了对案例处理逻辑的需求。
class Car
{
public void DisplayTransactions()
{
string name = Console.ReadLine();
if(name.ToLower() == "Joe")
{
//...
}
//Or.
if (name.ToUpper() == "Joe")
{
//...
}
}
}
原文
C# Coding Best Practices – Coding Conventions with Examples
标签:代码,string,C#,void,规范,number,命名,public From: https://blog.csdn.net/weixin_44231544/article/details/141553891