在C#编程中，partial分部类是一种允许将一个类的完整定义拆分到多个不同代码文件中的语法特性，通过partial关键字实现，最终编译时所有分散的定义会被合并成一个完整的类，类的功能和使用方式与普通类完全一致。
partial分部类的基础概念
partial分部类的核心是使用partial关键字修饰类，同一个分部类的所有部分都需要声明为partial，并且这些部分需要属于同一个命名空间、相同的访问修饰符。它并不会改变类的本质，只是在编码阶段拆分了定义，编译后和普通类没有任何区别。
分部类的适用场景
- 类的定义非常庞大，单个文件维护起来困难，拆分后可以按功能模块划分到不同文件
- 部分代码是自动生成的，比如WinForms窗体设计器生成的代码，拆分后可以避免手动修改自动生成代码带来的问题
- 团队协作开发时，同一个类的不同功能模块可以由不同开发者分别编写，减少代码冲突
分部类拆分定义的语法规则
分部类的拆分定义需要遵循固定的语法要求，否则编译会报错：
- 所有分部部分都必须使用
partial关键字修饰，且类名完全一致 - 所有分部部分必须位于同一个命名空间中
- 所有分部部分的访问修饰符必须一致，比如都是public或者都是internal
- 分部类可以包含方法、属性、字段、构造函数等所有类成员，拆分时成员可以任意分配在各个部分中
基础拆分示例
下面是一个最简单的分部类拆分示例，我们将一个Person类拆分到两个文件中定义。
第一个文件Person_Part1.cs的定义如下：
// 第一个分部类部分，定义基础字段和属性
public partial class Person
{
// 姓名属性
public string Name { get; set; }
// 年龄字段
private int age;
// 设置年龄的方法
public void SetAge(int inputAge)
{
if (inputAge > 0)
{
age = inputAge;
}
}
}
第二个文件Person_Part2.cs的定义如下：
// 第二个分部类部分，定义额外的方法和构造函数
public partial class Person
{
// 构造函数
public Person(string inputName)
{
Name = inputName;
}
// 打印个人信息的方法
public void PrintInfo()
{
Console.WriteLine("姓名：" + Name + "，年龄：" + age);
}
}
编译后这两个部分会合并成一个完整的Person类，我们可以像使用普通类一样使用它：
class Program
{
static void Main(string[] args)
{
Person p = new Person("张三");
p.SetAge(25);
p.PrintInfo(); // 输出：姓名：张三，年龄：25
}
}
分部类的注意事项
使用分部类时需要注意以下几点，避免出现编译错误或者逻辑问题：
- 分部类的所有部分都需要在编译时可用，不能部分定义在已编译的程序集中，部分定义在当前项目中
- 如果分部类的某个部分声明了基类，其他部分不需要重复声明，也不能声明不同的基类
- 分部类可以实现接口，接口可以在任意部分声明，不需要所有部分都声明
- 分部类的各个部分可以定义不同的partial方法，partial方法必须是void返回类型，且不能有访问修饰符，只能由分部类的其他部分实现
partial方法示例
partial方法是分部类中一个特殊的特性，方法声明在一个部分，实现可以在另一个部分：
// 第一个分部部分声明partial方法
public partial class Student
{
public string StudentName { get; set; }
// 声明partial方法，不需要实现
partial void OnNameChanged();
public void UpdateName(string newName)
{
StudentName = newName;
// 调用partial方法，如果没有实现就不会执行任何操作
OnNameChanged();
}
}
// 第二个分部部分实现partial方法
public partial class Student
{
// 实现partial方法
partial void OnNameChanged()
{
Console.WriteLine("学生姓名已更新为：" + StudentName);
}
}
当调用Student的UpdateName方法时，就会触发OnNameChanged方法的执行，如果第二个部分没有实现这个方法，调用时不会产生任何效果，也不会报错。
partial_classC#分部类分部类拆分partial关键字修改时间：2026-06-21 19:33:26