任务七方法是什么

一、方法的由来

案例：求一个整数的平方

int a = 5;
int result = a * a;
Console.WriteLine(result);

a = 6;
result = a * a;
Console.WriteLine(result);

a = 7;
result = a * a;
Console.WriteLine(result);

没有“方法”的概念，代码可能是这样的流水账。这段代码存在三个问题：

代码逻辑重复: 重复写相同的指令“输入一个数→计算平方→输出”。
维护困难，如果要修改求平方的逻辑或修改输出格式，需要修改多处。
可读性差：代码意图被重复的细节淹没。

代码的方法改造

第一步：方法体

使用花括号把重复的代码包裹起来，形成一个代码块，称之为“方法体”。我们希望方法体可以重复调用。

{
    int a = 5;
    int result = a * a;
    Console.WriteLine(result);
}

第二步：方法名

为了调用方法体，需要为“方法体”起个名字，我们起名叫Square。这个名字就叫“方法名"。

Square{
    int a = 5;
    int result = a * a;
    Console.WriteLine(result);
}

第三步：参数

删掉变量a的初始化值5。我们不需要初始化，我们需要每次向方法体内传入不同的值。可以这样做：在方法名Square后面再添加一组小括号,然后把int a移动到小括号内，记得去掉分号。小括号里定义的变量叫参数，用于接收外部传入的值。

Square(int a){
    int result = a * a;
    Console.WriteLine(result);
}

第四步：返回值

所有的方法必须设置返回值，在这里，返回值就是result。所以我们在代码底部，添加一行代码：return result;;同时必须在方法名的前面指定返回值的类型是int。最后可以把Console.WriteLine(result)删掉。

Square(int a){
    int result = a * a;
    return result;
}

第五步：static

static void Main(){
    Console.WriteLine(Square(6));
}

上面的代码Square(6)会报错：因为Main是一个静态方法，在静态方法内只能调用静态方法，所以修改第四步的代码：

static int Square(int a){
    int result = a * a;
    //Console.WriteLine(result);
    return result;
}

第六步：调用方法

在方法名Square()后面紧跟着写一组小括号，小括号在这里表示”执行“。当调用“方法名和小括号”时就可以执行方法体内的代码：

Square()

二、方法是什么

1.方法是重复调用的代码块

方法是一段可以被重复调用的代码块，

来一个简单的例子：

static void SayHello()
{
    Console.WriteLine("你好，欢迎学习C#！");
}

2.方法是操作数据的行为

方法定义在类中，与类中的数据（字段 / 属性）绑定，。它通过操作类中的数据，实现特定的功能。

为什么要和数据绑定？因为现实世界中，“行为” 总是属于某个 “事物” 的。比如：

“计算面积” 这个行为，属于 “圆”（需要圆的半径数据） “考试得分” 这个行为，属于 “学生”（需要学生的答题情况数据）

在 C# 中，方法作为类的成员，天然可以访问类中的数据，实现 “数据 + 行为” 的封装：

class Circle {
    public double Radius;  // 数据（半径）
    
    // 方法（行为）：计算面积（直接使用类中的Radius数据）
    public double CalculateArea() {
        return 3.14 * Radius * Radius;
    }
}

三、定义方法的语法结构

1.基础语法

修饰符 返回值类型 方法名([数据类型 参数名[,数据类型 参数名]])
{
    // 方法体：具体的操作逻辑
    [return 返回值;] 
}

示例

// 示例：计算两个整数的和
public int Add(int num1, int num2)
{
    int result = num1 + num2;
    return result; // 返回计算结果
}

2.方法头

方法头

方法头指定方法的特征。包括：

方法是否返回数据，如果返回，返回什么类型；
方法的名称；
哪种类型的数据可以传递给方法或从方法返回，以及应如何处理这些数据。

方法头

示例

void MyMethod()
{
    Console.WriteLine("First");
    Console.WriteLine("Last");
}

3.方法体

方法体是一个语句块。
方法体是花括号包裹起来的语句序列。

方法体包含以下项目：

局部变量
局部函数
控制流结构
方法调用
内嵌的块

方法头

四、调用方法的语法

方法定义好后，需要通过对象来调用。就像现实中“学生张三上课”，在代码中就是“张三对象调用AttendClass方法”：

对象名.方法名(参数);

如果方法有返回值，还可以用变量接收返回的结果。

示例：

// 创建对象
Student zhangSan = new Student();
zhangSan.Name = "张三";

// 调用方法
zhangSan.AttendClass(); // 输出：张三正在认真上课

// 调用带参数的方法
int examScore = zhangSan.TakeExam(100); // 传入100道题
Console.WriteLine($"{zhangSan.Name}的考试分数是：{examScore}");

五、方法名命名规则

基本语法规则（必须遵守）

这些是编译器会检查的硬性规则，违反会导致编译错误：

不能以数字开头
方法名必须以字母（a-z、A-Z）或下划线（_）开头，后续可以包含字母、数字或下划线。
❌ 错误示例：123Calculate()、3Sum()
✅ 正确示例：Calculate123()、Sum3()
不能包含特殊字符
不能使用@、#、$、%等特殊符号（下划线_除外），也不能包含空格。
❌ 错误示例：Get-User()、Calculate$Total()
✅ 正确示例：GetUser()、CalculateTotal()
不能使用C#关键字
不能直接使用class、int、void等C#保留字作为方法名。如果必须使用（极特殊情况），需在关键字前加@（不推荐）。
❌ 错误示例：class()、void()
✅ 特殊情况：@class()（不建议使用）

通用命名规范(建议严格遵守)

这些是微软官方推荐（Framework Design Guidelines）的规则，是C#开发者的共识：

使用帕斯卡命名法（PascalCase）
方法名的每个单词首字母大写，其余字母小写，不使用下划线分隔。这是C#方法命名最核心的规范。
❌ 错误示例：getuser()、Get_user()、getUser()
✅ 正确示例：GetUser()、CalculateTotal()、PrintInfo()

对比：变量/参数使用驼峰命名法（camelCase，首字母小写），而方法名必须用帕斯卡命名法，这是两者的关键区别。
使用动词或动词短语
方法表示“行为”，命名应体现“做什么”，通常以动词开头，清晰描述方法的功能。
❌ 不推荐：UserInfo()、TotalAmount()（更像属性名）
✅ 推荐：GetUserInfo()、CalculateTotalAmount()、SaveData()、ValidateInput()
避免缩写（除非是广为人知的缩写）
尽量使用完整单词，不随意缩写，除非是公认的缩写（如ID、URL、API）。
❌ 不推荐：GetUsr()、CalcTot()、UpdData()
✅ 推荐：GetUser()、CalculateTotal()、UpdateData()、GetID()（ID是公认缩写）
体现参数和返回值的含义
如果方法有明确的参数或返回值，命名应暗示其用途，让调用者无需查看内部实现就能理解。
❌ 模糊示例：Process()、Handle()、DoSomething()
✅ 清晰示例：
- ProcessOrder(int orderId)（处理指定ID的订单）
- ConvertToInt(string input)（将字符串转换为int）
- IsValidEmail(string email)（返回bool，验证邮箱是否有效）

方法重载的命名
重载方法（同名不同参数）应保持名称一致，通过参数列表区分，名称需能概括所有重载的共同功能。

// 正确：重载方法名称一致，都体现“添加用户”的功能
public void AddUser(string name) { .. }
public void AddUser(string name, int age) { .. }
public void AddUser(User user) { .. }

特殊场景的命名规范

构造函数
必须与类名完全相同（遵循类名的帕斯卡命名法），无返回值。

public class Student
{
    // 构造函数：与类名一致
    public Student(string name) { .. }
}

异步方法
异步方法（返回Task或Task<T>）需在末尾添加Async后缀，明确表示这是异步操作。
❌ 不推荐：GetData()（异步方法）
✅ 推荐：GetDataAsync()
```
public async Task<string> GetDataAsync()
{
    // 异步逻辑
}
```

事件相关方法
触发事件的方法通常以On开头，后跟事件名（如OnClick、OnDataReceived）。

protected virtual void OnUserLoggedIn(EventArgs e)
{
    UserLoggedIn?.Invoke(this, e); // 触发事件
}

布尔返回值的方法
返回bool的方法通常以Is、Has、Can等前缀开头，明确表示“是否/有无/能否”。
✅ 示例：IsEmpty()、HasPermission()、CanExecute()、ContainsKey()

小结

C#方法命名的关键规则可归纳为：

语法上：字母/下划线开头，无特殊字符，不使用关键字。
格式上：严格使用帕斯卡命名法（每个单词首字母大写）。
语义上：用动词短语，清晰描述功能，避免缩写，体现参数和返回值含义。

遵循这些规则，能让你的代码更符合C#社区的习惯，便于团队协作和后续维护。记住：好的命名是写给“人”看的，不是给编译器看的。

六、定义方法的位置

静态方法既可以定义在Program类中，也可以定义在自定义类中，具体取决于你的代码设计需求：

1.定义在Program类中

如果是临时的、仅在入口附近使用的简单方法，放在Program类中更简洁。

class Program
{
    static void Main(string[] args)
    {
        int num = 5;
        int square = Square(num); // 直接调用同类型中的静态方法
    }

    // 定义在Program类中
    static int Square(int a)
    {
        return a * a;
    }
}

2.定义在自定义类中

如果是可复用的功能（比如多个地方需要计算平方），放在自定义类中更符合“封装”思想，也让代码结构更清晰（遵循“单一职责原则”：一个类专注于一类功能）。方便复用和管理：

// 自定义工具类
class MathHelper
{
    // 定义在自定义类中
    public static int Square(int a)
    {
        return a * a;
    }
}

class Program
{
    static void Main(string[] args)
    {
        int num = 5;
        // 通过类名调用自定义类中的静态方法
        int square = MathHelper.Square(num); 
    }
}

七、修饰符

见: 修饰符

八、返回值类型

返回值类型（Return Type） 决定了方法执行完毕后返回的结果值的数据类型。

1. 无返回值：`void` 关键字

如果方法只是执行一系列动作（如打印日志、修改变量），不需要返回任何计算结果，则必须使用 void。

特点：方法体内可以不写 return，或者只写 return;（用于提前结束方法）。
示例：

public void PrintMessage(string msg)
{
    Console.WriteLine(msg);
    // 不需要 return
}

2. 返回基本类型或对象

方法可以返回任何有效的 C# 类型，包括内置类型（int, string, bool）或自定义的类（User, Order）。

规则：方法体必须通过 return 关键字返回一个与声明类型兼容的值。
示例：

public int Add(int a, int b)
{
    return a + b; // 必须返回 int
}

public User GetUserById(int id)
{
    return new User { Id = id }; // 返回一个对象
}

3. 返回多个值：元组 (Tuples)

在 C# 7.0 及更高版本中，如果你想让一个方法返回多个相关的数据，而又不想专门定义一个类，可以使用元组。

语法：用括号 () 包裹多个类型。
示例：

public (int min, int max) GetLimits()
{
    return (1, 100); 
}

// 调用时：
var result = GetLimits();
Console.WriteLine(result.min);

4. 异步返回值：`Task` 与 `ValueTask`

在处理网络请求、文件读取等耗时操作时，C# 使用异步编程模型。此时返回值类型会发生变化。

声明类型	实际返回含义	对应非异步类型
`Task`	异步操作完成，但不返回数据。	`void`
`Task<T>`	异步操作完成，返回 `T` 类型数据。	`T`

示例：

public async Task<string> DownloadDataAsync()
{
    // 模拟异步下载
    await Task.Delay(1000);
    return "下载完成的数据"; 
}

5. 核心规则与注意事项

A. 返回路径完整性

如果方法声明了非 void 的返回值，编译器会检查所有可能的路径是否都有 return 语句。

public string CheckStatus(bool ok)
{
    if (ok) return "成功";
    // 报错：并非所有的代码路径都返回值（如果 ok 为 false 怎么办？）
}

B. 协变性 (Covariance)

你可以返回声明类型的子类。例如，如果返回值类型是 Animal，你可以 return new Dog();。

C. 表达式主体方法 (Expression-bodied members)

对于只有一行返回逻辑的方法，可以使用 => 符号简化：

public int Square(int x) => x * x; 

总结对照表

场景	返回值类型声明	return 语句
纯动作，无回执	`void`	无，或 `return;`
返回计算结果	`int`, `string`, `double` 等	`return 变量;`
返回复杂数据	`List<T>`, `MyClass`	`return 实例;`
返回多个零散数据	`(int, string)`	`return (1, "OK");`
异步方法	`Task<T>`	`return 变量;` (配合 async/await)

九、参数列表

见: 参数列表

十、示例：学生类

我们来给“学生类”添加几个成员方法：

class Student
{
    // 属性：存储数据
    public string Name { get; set; }
    public int Score { get; set; }

    // 成员方法：上课
    public void AttendClass()
    {
        Console.WriteLine($"{Name}正在认真上课");
    }

    // 成员方法：考试（带参数和返回值）
    public int TakeExam(int questionsCount)
    {
        // 模拟考试得分：做对80%的题目
        int score = (int)(questionsCount * 0.8);
        Score = score; // 操作类中的属性
        return score; // 返回考试分数
    }
}

在这个例子中，AttendClass和TakeExam都是Student类的成员方法。它们都定义在类的内部，能够直接访问类中的属性。

一、方法的由来​

二、方法是什么​

1.方法是重复调用的代码块​

2.方法是操作数据的行为​

三、定义方法的语法结构​

1.基础语法​

2.方法头​

3.方法体​

四、调用方法的语法​

五、方法名命名规则​

基本语法规则（必须遵守）​

通用命名规范(建议严格遵守)​

特殊场景的命名规范​

六、定义方法的位置​

1.定义在Program类中​

2.定义在自定义类中​

七、修饰符​

八、返回值类型​

1. 无返回值：void 关键字​

2. 返回基本类型或对象​

3. 返回多个值：元组 (Tuples)​

4. 异步返回值：Task 与 ValueTask​

5. 核心规则与注意事项​

A. 返回路径完整性​

B. 协变性 (Covariance)​

C. 表达式主体方法 (Expression-bodied members)​

总结对照表​

九、参数列表​

十、示例：学生类​