二、C#中的注释和命名规范
1、注释
注释一般都以下两种作用:
说明当前代码的作用以及意义。
暂时去掉不用代码,让其不参与编译。
C#中包含三种注释:
1)单行注释
使用两个斜杠代表其后内容是注释部分。
举例如下:
//定义一个变量值。(单行注释)
int value = 5;
2)多行注释
使用/* */ 代表多行注释,期间的所有内容都是注释部分。
举例如下:
/* 多行注释,期间的所有说明或者代码都是注释部分。
double d = 3.25
int value = 5;
*/
3)文档注释
文档注释一般多用于类和方法的前面,说明该类和方法的作用以及意义。
举例如下:
在方法或者类的前一行打出三个斜杠,VS自动添加文档注释。
using System;
namespace ConsoleApp1
/// <summary>
/// 这是文档注释7
/// 这个是VS自动生成的Program类
/// </summary>
class Program
{
/// <summary>
/// 这个是主函数,是程序的入口
/// </summary>
/// <param name="args">参数说明</param>
static void Main(string[] args)
{
Console.WriteLine("Hello World");
}
Tips:
平时写代码时也要有为代码添加注释的习惯。这样写出来的代码不仅美观,更容易维护。
2、命名规范
命名规则是为了让整个程序代码统一以增强其可读性而设置的。
常用的命名方法有两种:
Pascal 命名法(帕斯卡命名法):每个单词的首字母大写
Camel 命名法(驼峰命名法):第一个单词小写,从第二个单词开始每个单词的首字母大
写
- 变量的命名规则
变量的命名规则遵循 Camel 命名法,并尽量使用能描述变量作用的英文单词。例如存放学
生姓名的变量可以定义成 name 或者 studentName 等。另外,变量名字也不建议过长,
最好是 1 个单词,最多不超过 3 个单词。
2) 常量的命名规则
为了与变量有所区分,通常将定义常量的单词的所有字母大写。例如定义求圆面积的 n 的
值,可以将其定义成一个常量以保证在整个程序中使用的值是统一的,直接定义成 PI 即可。
3) 类的命名规则
类的命名规则遵循 Pascal 命名法,即每个单词的首字母大写。例如定义一个存放学生信息
的类,可以定义成 Student。
- 接口的命名规则
接口的命名规则也遵循 Pascal 命名法,但通常都是以 I 开头,并将其后面的每个单词的首
字母大写。例如定义一个存放值比较操作的接口,可以将其命名为 ICompare。
5) 方法的命名规则
方法的命名遵循 Pascal 命名法,一般采用动词来命名。例如实现添加用户信息操作的方
法,可以将其命名为 AddUser。
三、变量和常量
1、变量
变量(Variable)是 C# 编程中不可缺失的内容,使用变量可以更容易地完成程序的编
写。
变量可以理解为存放数据的容器,并且在将值存放到变量中时还要为变量指定数据类型。
定义变量的语法如下:
数据类型 变量名;
数据类型 变量名 = 初始值;
注意:
对于未初始化的变量,其内容无法确定,所以无法进行直接输出显示,需要设置值之后再进
行输出。
举例如下:
//定义一个变量,但未设置初始值
int value;
//定义一个变量,并设置初始值为5
int num = 5;
2、常量
常量也是用来存储数据的容器,在定义时都需要指明数据类型。
唯一的特点是:存放的值不允许改变。
常量需要使用关键字const进行修饰。
常量一般全部使用大写。
举例如下:
//定义一个常量
const int CONST_VALUE = 5;
CONST_VALUE = 10; //语法错误,试图修改一个常量
【实例1】分别求圆的面积和周长,并使用常量存放 π 的值,将 π 的值定义为3.14。
class Program
{
static void Main(string[] args)
{
const double PI = 3.14;
int r = 3; //存放半径
Console.WriteLine("圆的周长是:" + 2 * PI * r);
Console.WriteLine("圆的面积是:" + PI * r * r);
}
}