在C#的面向对象编程中，partial关键字用于将一个类、结构体、接口或者方法的定义拆分到多个源文件中，拆分后的各个部分在编译时会被合并成一个完整的类型。这种特性非常适合处理代码生成场景或者大型类的拆分场景，能够有效降低单个文件的代码复杂度。
partial类的基本概念
partial类指的是使用partial关键字修饰的类，它的定义可以分布在多个不同的.cs文件中。编译时，编译器会将所有同名的partial类的各个部分合并成一个完整的类，最终生成的IL代码和直接定义在一个文件中的类没有任何区别。
使用partial类需要满足几个基础规则：
- 所有分部类的定义都必须使用
partial关键字修饰 - 所有分部类的定义必须属于同一个命名空间
- 所有分部类的定义必须具有相同的可访问性，比如都是public或者都是internal
- 如果某个分部类被声明为抽象或者密封，那么所有分部类都必须带有相同的修饰符
partial类的使用示例
下面演示如何将同一个User类的定义拆分到两个文件中。
第一个文件：User_Part1.cs
// 第一个分部类，定义基础属性和构造函数
public partial class User
{
public string Name { get; set; }
public int Age { get; set; }
public User(string name, int age)
{
Name = name;
Age = age;
}
}
第二个文件：User_Part2.cs
// 第二个分部类，定义方法
public partial class User
{
public void PrintUserInfo()
{
Console.WriteLine($"姓名：{Name}，年龄：{Age}");
}
public bool IsAdult()
{
return Age >= 18;
}
}
编译后，User类会包含所有的属性和方法，我们可以像使用普通类一样使用它：
class Program
{
static void Main()
{
User user = new User("张三", 20);
user.PrintUserInfo(); // 输出：姓名：张三，年龄：20
Console.WriteLine(user.IsAdult()); // 输出：True
}
}
partial方法的基本概念
partial方法是定义在partial类中的特殊方法，它分为声明和实现两个部分，同样可以分布在不同文件中。partial方法有以下特点：
- partial方法必须是void返回类型，不能有返回值
- partial方法可以有参数，但参数不能使用out修饰符
- partial方法的声明和实现都必须使用
partial关键字修饰 - 如果partial方法只有声明没有实现，编译器会在编译时移除该方法的所有调用，不会产生运行时开销
- partial方法默认是private的，不能添加访问修饰符
partial方法的使用示例
下面演示partial方法的声明和实现拆分到不同文件的情况。
第一个文件：Order_Part1.cs
public partial class Order
{
public string OrderId { get; set; }
// 声明partial方法
partial void OnOrderCreated();
public Order(string orderId)
{
OrderId = orderId;
// 调用partial方法，如果没有实现则编译时会移除该调用
OnOrderCreated();
}
}
第二个文件：Order_Part2.cs
public partial class Order
{
// 实现partial方法
partial void OnOrderCreated()
{
Console.WriteLine($"订单{OrderId}已创建");
}
}
调用Order类的构造函数时，会触发OnOrderCreated方法的执行：
class Program
{
static void Main()
{
Order order = new Order("ORD001"); // 输出：订单ORD001已创建
}
}
partial类和方法的适用场景
partial类和方法的常见使用场景包括：
- 代码生成工具生成的代码和开发者手动编写的代码分离，比如WinForms、WPF设计器生成的代码会放在partial类中，开发者可以在另一个分部类中编写业务逻辑，避免手动修改生成代码导致下次生成时被覆盖
- 大型类的拆分，当一个类的功能模块较多、代码量过大时，可以按照功能模块将类拆分到多个文件中，提升代码的可读性和可维护性
- 团队协作时，不同开发者可以负责同一个类的不同分部文件，减少代码合并冲突的概率
注意：partial只是编译时的特性，不会影响运行时的类型结构，拆分后的类在运行时和单个文件中定义的类完全一致。
partial_classpartial_methodC#类拆分分部类修改时间：2026-07-16 06:27:24