partial是一个类修饰符,用于把类定义拆分为几个部分,便于代码管理,如
class ClassA
{
void A(){;}
void B(){;}
}
与
partial class ClassA
{
void A(){;}
}
partial class ClassA
{
void B(){;}
}
是一样的
详细介绍如下:
可以将类、结构或接口的定义拆分到两个或多个源文件中。每个源文件包含类定义的一部分,编译应用程序时将把所有部分组合起来。在以下几种情况下需要拆分类定义:
处理大型项目时,使一个类分布于多个独立文件中可以让多位程序员同时对该类进行处理。
使用自动生成的源时,无需重新创建源文件便可将代码添加到类中。Visual Studio 在创建 Windows 窗体、Web 服务包装代码等时都使用此方法。您无需编辑 Visual Studio 所创建的文件,便可创建使用这些类的代码。
若要拆分类定义,请使用 partial 关键字修饰符,如下所示:
C# 复制代码
public partial class Employee
{
public void DoWork()
{
}
}
public partial class Employee
{
public void GoToLunch()
{
}
}
备注
使用 partial 关键字表明可在命名空间内定义该类、结构或接口的其他部分。所有部分都必须使用 partial 关键字。在编译时,各个部分都必须可用来形成最终的类型。各个部分必须具有相同的可访问性,如 public、private 等。
如果将任意部分声明为抽象的,则整个类型都被视为抽象的。如果将任意部分声明为密封的,则整个类型都被视为密封的。如果将任意部分声明为基类型,则整个类型都将继承该类。
指定基类的所有部分必须一致,但忽略基类的部分仍继承该基类型。各个部分可以指定不同的基接口,最终类型将实现所有分部声明所列出的全部接口。在某一分部定义中声明的任何类、结构或接口成员可供所有其他部分使用。最终类型是所有部分在编译时的组合。
注意
分部修饰符不可用于委托或枚举声明中。
嵌套类型可以是分部的,即使它们所嵌套于的类型本身并不是分部的也如此。例如:
C# 复制代码
class Container
{
partial class Nested
{
void Test() { }
}
partial class Nested
{
void Test2() { }
}
}
编译时将对分部类型定义的属性进行合并。例如,下面的声明:
C# 复制代码
[System.SerializableAttribute]
partial class Moon { }
[System.ObsoleteAttribute]
partial class Moon { }
等效于:
C# 复制代码
[System.SerializableAttribute]
[System.ObsoleteAttribute]
class Moon { }
将从所有分部类型定义中对以下内容进行合并:
XML 注释
interfaces
泛型类型参数属性
类属性
成员
例如,下面的声明:
C# 复制代码
partial class Earth : Planet, IRotate { }
partial class Earth : IRevolve { }
等效于:
C# 复制代码
class Earth : Planet, IRotate, IRevolve { }
限制
处理分部类定义时需遵循下面的几个规则:
要作为同一类型的各个部分的所有分部类型定义都必须使用 partial 进行修饰。例如,下面的类声明将生成错误:
C# 复制代码
public partial class A { }
//public class A { } // Error, must also be marked partial
partial 修饰符只能出现在紧靠关键字 class、struct 或 interface 前面的位置。
分部类型定义中允许使用嵌套的分部类型,例如:
C# 复制代码
partial class ClassWithNestedClass
{
partial class NestedClass { }
}
partial class ClassWithNestedClass
{
partial class NestedClass { }
}
要成为同一类型的各个部分的所有分部类型定义都必须在同一程序集和同一模块(.exe 或 .dll 文件)中进行定义。分部定义不能跨越多个模块。
类名和泛型类型参数在所有的分部类型定义中都必须匹配。泛型类型可以是分部的。每个分部声明都必须以相同的顺序使用相同的参数名。
下面的用于分部类型定义中的关键字是可选的,但是如果某关键字出现在一个分部类型定义中,则该关键字不能与在同一类型的其他分部定义中指定的关键字冲突:
public
private
protected
internal
abstract
sealed
基类
new 修饰符(嵌套部分)
一般约束(有关更多信息,请参见类型参数的约束(C# 编程指南)。)
示例 1
下面的示例在一个分部类定义中声明类 CoOrds 的字段和构造函数,在另一个分部类定义中声明成员 PrintCoOrds。
C# 复制代码
public partial class CoOrds
{
private int x;
private int y;
public CoOrds(int x, int y)
{
this.x = x;
this.y = y;
}
}
public partial class CoOrds
{
public void PrintCoOrds()
{
System.Console.WriteLine("CoOrds: {0},{1}", x, y);
}
}
class TestCoOrds
{
static void Main()
{
CoOrds myCoOrds = new CoOrds(10, 15);
myCoOrds.PrintCoOrds();
}
}
输出
CoOrds: 10,15
示例 2
从下面的示例可以看出,您也可以开发分部结构和接口。
C# 复制代码
partial interface ITest
{
void Interface_Test();
}
partial interface ITest
{
void Interface_Test2();
}
partial struct S1
{
void Struct_Test() { }
}
partial struct S1
{
void Struct_Test2() { }
}