分部类型与文件
使用分部类/结构体将一个类型拆分到多个文件中，并使用分部方法将自定义逻辑接入生成的代码。
分部类型与文件 是 CoddyKit 上的免费 C# Academy 课时。 这是第 3 节课，共 3 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 C# Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 C# Academy 课程共包含 3 节课。
partial 类型概览
目标：以清晰的方式拆分大型类型。
- partial 类/结构体：相同的命名空间和名称
- 通常分布在多个文件中
- partial 方法：partial 类型中的可选挂钩
partial 类的组成部分
一个partial 类可以声明为多个部分。编译器会将它们合并为一个类型。
using System;
namespace Demo
{
// Part 1: data
public partial class Person
{
public string Name { get; private set; }
public Person(string name) { Name = name; }
}
// Part 2: behavior
public partial class Person
{
public string Greet() { return "Hi " + Name; }
}
}
public class Program
{
public static void Main(string[] args)
{
Demo.Person p = new Demo.Person("Ada");
Console.WriteLine(p.Greet());
}
}
partial 方法
partial 方法是编译时挂钩：如果未实现，调用就会被移除。在 C# 6 中，它们必须是无返回值的，并且是私有的。
using System;
namespace Demo
{
public partial class Processor
{
// Partial method: implicitly private, must return void in C# 6
partial void OnProcessed(string item);
public void Run(string item)
{
// do work...
OnProcessed(item); // call hook (removed by compiler if not implemented)
}
}
public partial class Processor
{
// Implementation lives in another part (often another file)
partial void OnProcessed(string item)
{
Console.WriteLine("Processed: " + item);
}
}
}
public class Program
{
public static void Main(string[] args)
{
Demo.Processor p = new Demo.Processor();
p.Run("report");
}
}
何时使用 partial
使用场景：
- 将设计器或生成的代码放在一个文件中，将您可以安全编辑的内容放在另一个文件中。
- 按功能拆分大型类型：数据与行为分开。
- 通过partial 方法提供可选挂钩。
partial 结构体
您也可以使用 partial 拆分结构体；在编译时，结果仍是一个结构体类型。
using System;
namespace Demo
{
public partial struct Pair
{
public int A;
}
public partial struct Pair
{
public int B;
public int Sum() { return A + B; }
}
}
public class Program
{
public static void Main(string[] args)
{
Demo.Pair p = new Demo.Pair();
p.A = 2; p.B = 3;
Console.WriteLine("Sum = " + p.Sum());
}
}
partial 规则与提示
提示：
- 所有部分必须使用相同的命名空间、名称和访问修饰符。
- 让每个文件各司其职（生成代码与手写代码分开）。
- 在 C# 6 中，partial 方法是无返回值的，并且是私有的；请让它们保持简短。
partial 类的用途
回顾
回顾：使用 partial 将类型拆分到多个文件中，并添加partial 方法来提供可选挂钩。让各部分保持相同的命名空间和名称，并交由编译器将它们合并。
常见问题解答
「分部类型与文件」课时是免费的吗？
是的 — 「分部类型与文件」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 C# Academy 课程的其余内容，请升级到 CoddyKit PRO。 C# Academy 课程共包含 3 节课。
「分部类型与文件」这节课中我会学到什么？
使用分部类/结构体将一个类型拆分到多个文件中，并使用分部方法将自定义逻辑接入生成的代码。 你通过在浏览器中直接运行的动手代码来练习 C# Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 C# Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 C# Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 3 节课，共 3 节。
「分部类型与文件」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 C# Academy 课中编写并运行代码吗？
能。每节 C# Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。