C# Partial：分部方法和分部类代码实例

结果或目标

通过以下代码实例，展示 C# 分部类的结构以及如何正确声明和使用分部方法，同时验证未实现分部方法不会导致编译错误且无运行时开销。

准备条件

• C# 开发环境
• 对 partial 关键字的基本认知

真实操作顺序

第1步：构建基础分部类结构

目的：创建包含构造函数和逻辑调用的分部类，用于演示分部方法的调用流程。 动作：定义一个名为 A 的部分类。在该类中编写构造函数，并在其中调用两个方法：PrintHello() 和 PrintWorld()。这两个方法将在后续步骤中被定义为分部方法。

using System;

namespace Partial
{
    partial class A
    {
        public A()
        {
            PrintHello();
            PrintWorld();
            Console.Read();
        }

        partial void PrintHello()
        {
            Console.Write("Hello");
        }
    }
}

第2步：定义分部方法声明

目的：在另一个文件（或使用 partial 关键字拆分）中完整定义分部类的其余部分，包括未实现的分部方法。
重要参数/约束：

• 返回类型必须为 void。
• 不能接受 out 参数。
• 可以是只存在声明而不实现。

    // 这是同一类的另一部分
    partial class A
    {
        // 分部方法必须存在如下声明，返回类型只可以为void，且不接受Out参数
        // 分部方法可以只存在声明而不实现它
        // 未实现的分部方法在代码生成时会自动被编译器移除，不会带来额外的开销
        partial void PrintHello();
        partial void PrintWorld();
    }

第3步：运行程序观察结果

完成状态：在 Main 函数中实例化 A 对象。执行后控制台仅输出 “Hello”，而不会产生任何关于 PrintWorld 缺失实现的编译错误。

原文有依据的排错

问题：为什么没有声明 PrintWorld 的实现却不会报错？
解析：C# 编译器具有特殊的处理机制。当分部方法被声明但未在任何分部部分提供实现体时，编译器会在生成的中间语言（IL）中完全剥离对该方法的调用及相关声明。因此，这等同于这些代码从未存在过，不会引入任何额外开销或引发异常。

简要总结

分部类允许将类的定义分散到多个文件中，这在生成大量代码或由不同开发人员维护时非常有用。分部方法则提供了一种更灵活的扩展点，特别是在代码生成器场景下，开发者可以选择性地实现某些回调方法。利用这一特性，可以实现功能模块化且保持代码整洁。