partial关键字允许将类、结构、接口或方法拆分到多个文件中,编译时自动合并,适用于大型项目和代码生成场景。

在C#中,partial 关键字允许你将一个类、结构、接口或方法的定义拆分到多个文件中。编译时,这些部分会被合并成一个完整的类型。这在大型项目或代码生成场景中特别有用,比如 Windows Forms、WPF 或 Entity Framework 中,设计器文件和用户代码可以分开管理。
partial 类的作用
使用 partial class 可以把一个类的成员分布在多个 .cs 文件中。每个文件都使用 partial 修饰类名,编译器会在编译时将它们组合起来。
例如,有一个类 Person,你可以将属性定义在一个文件中,方法定义在另一个文件中:
// Person.Name.cs
public partial class Person
{
public string FirstName { get; set; }
public string LastName { get; set; }
}
// Person.Methods.cs
public partial class Person
{
public string GetFullName()
{
return $"{FirstName} {LastName}";
}
}
编译后,Person 类就同时拥有属性和方法,就像它们写在一个文件里一样。
partial 方法的使用
partial method 只能在 partial class 中定义,且只能声明在其中一个部分中,实现可选。如果没有任何部分提供实现,编译器会自动移除该调用,不会报错。
这常用于代码生成工具:生成的代码中声明一个 partial 方法,开发者可在另一个部分中选择性地实现它。
// 自动生成的文件(Person.Generated.cs)
public partial class Person
{
partial void OnNameChanged(); // 声明
public string Name
{
get => _name;
set
{
_name = value;
OnNameChanged(); // 调用,若无实现则被移除
}
}
}
// 开发者文件(Person.Custom.cs)
public partial class Person
{
partial void OnNameChanged()
{
Console.WriteLine("Name was changed!");
}
}
如果没有在任何部分实现 OnNameChanged,调用会被忽略,不产生运行时开销。
拆分类定义的注意事项
- 所有部分必须使用 partial 关键字
- 所有部分必须在同一程序集中(不能跨 assembly)
- 访问修饰符以实际定义为准,但通常建议保持一致
- 泛型参数、基类等可以在任意部分声明,最终会合并
- 不能重复定义同一个成员(如两个同名属性)
基本上就这些。合理使用 partial 类可以让代码更清晰,特别是在自动生成代码与手动编写代码共存的场景下。










