C# - partial 关键字
引言
partial
关键字用于拆分一个类、一个结构、一个接口或一个方法的定义到两个或更多的文件中。 每个源文件包含类型或方法定义的一部分,编译应用程序时将把所有部分组合起来。在设计 Framework 时,可以充分利用 partial
这个特性。
分部类
什么情况下需要拆分类定义呢?
- 处理大型项目时,使一个类分布于多个独立文件中可以让多位程序员同时对该类进行处理。
- 当使用自动生成的源文件时,你可以添加代码而不需要重新创建源文件。 Visual Studio 在创建 Windows 窗体、Web 服务包装器代码等时会使用这种方法。 你可以创建使用这些类的代码,这样就不需要修改由 Visual Studio 生成的文件。
- 使用源生成器在类中生成附加功能时。
例子
将 Coords 类 分部在 2 个文件中定义。
CoordsOne.cs
定义了 Coords 类的构造函数
注意签名 partial class Coords
namespace ConsoleApp1.PartialClass
{
public partial class Coords
{
private int x;
private int y;
public Coords(int x, int y)
{
this.x = x;
this.y = y;
}
}
}
CoordsTwo.cs
定义了 Coords 类的一个方法
注意签名 partial class Coords
namespace ConsoleApp1.PartialClass
{
public partial class Coords
{
public void PrintCoords()
{
Console.WriteLine("Coords: {0},{1}", x, y);
}
}
}
TestPartial.cs
测试一下上面的分部类
using ConsoleApp1.PartialClass;
namespace ConsoleApp1
{
internal class TestPartial
{
static void Main(string[] args)
{
Coords coords = new Coords(10, 20);
coords.PrintCoords();
}
}
}
结果:
Coords: 10,20
partial 分部限制
处理分部类定义时需遵循下面的几个规则:
- 要作为同一类型的各个部分的所有分部类型定义都必须使用
partial
进行修饰。
例如,下面的类声明会生成错误:
public partial class A { }
//public class A { } // Error, must also be marked partial
-
partial
修饰符只能出现在紧靠关键字class
、struct
或interface
前面的位置。 -
分部类型定义中允许使用嵌套的分部类型,如下面的示例中所示:
partial class ClassWithNestedClass
{
partial class NestedClass { }
}
partial class ClassWithNestedClass
{
partial class NestedClass { }
}
-
要成为同一类型的各个部分的所有分部类型定义都必须在同一程序集和同一模块(.exe 或 .dll 文件)中进行定义。 分部定义不能跨越多个模块。
经测试这些分部的文件必须在同一命名空间
。
还是上面的例子,CoordsThree.cs 也定义成partial
类,但是相比 CoordsOne.cs 和 CoordsTwo.cs 不是在同一个命名空间,会出错。 -
类名和泛型类型参数在所有的分部类型定义中都必须匹配。 泛型类型可以是分部的。 每个分部声明都必须以相同的顺序使用相同的参数名。
-
如果某关键字出现在一个分部类型定义中,则该关键字不能与在同一类型的其他分部定义中指定的关键字冲突:public,private,protected,internal,abstract,sealed 等
将 CoordsOne.cs 中 public 改成 internal,产生访问属性冲突。
分部接口和结构
同理,也可以开发分部结构和接口
partial interface ITest
{
void Interface_Test();
}
partial interface ITest
{
void Interface_Test2();
}
partial struct S1
{
void Struct_Test() { }
}
partial struct S1
{
void Struct_Test2() { }
}
分部方法
分部方法在分部类型的一部分中定义了签名,并在该类型的另一部分中定义了实现。 通过分部方法,类设计器可提供与事件处理程序类似的方法挂钩,以便开发者决定是否实现。 如果开发者不提供实现,则编译器在编译时删除签名。 以下条件适用于分部方法:
-
声明必须以上下文关键字
partial
开头。 -
分部类型各部分中的签名必须匹配。
-
构造函数、终结器、重载运算符、属性声明或事件声明中不允许使用
partial
关键字。
例如:
namespace PM
{
partial class A
{
partial void OnSomethingHappened(string s);
}
// This part can be in a separate file.
partial class A
{
// Comment out this method and the program
// will still compile.
partial void OnSomethingHappened(String s)
{
Console.WriteLine("Something happened: {0}", s);
}
}
}
在以下情况下,不需要使用分部方法即可实现:
- 没有任何可访问性修饰符(包括默认的 专用)。
- 返回 void。
- 没有任何输出参数。
- 没有以下任何修饰符:virtual、override、sealed、new 或 extern。
this 和 partial 的区别
C# - this 的用法 一文中有介绍 this 具有扩展类方法的功能,那么 this
和 partial
有区别是?
- 概念的区别,
this
是对原有功能进行扩展,partial
是将整体分成多个部分存放,便于维护。 - 实现方式的区别
patial
分部的签名要求一致,必须是partial
class/interface/struct Name,文件名不一样。
this 扩展类名不一样,但必须是静态的类,静态的方法,方法第一个参数必须是this
ClassName - 调用的区别
partial
分部的各个文件必须在同一 namespace 命名空间this
扩展可以在不同命名空间,但是需要导入扩展的 namespace 命名空间后才能调用扩展的方法。
这篇好文章是转载于:学新通技术网
- 版权申明: 本站部分内容来自互联网,仅供学习及演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系,请提供相关证据及您的身份证明,我们将在收到邮件后48小时内删除。
- 本站站名: 学新通技术网
- 本文地址: /boutique/detail/tanhgbigja
-
photoshop保存的图片太大微信发不了怎么办
PHP中文网 06-15 -
《学习通》视频自动暂停处理方法
HelloWorld317 07-05 -
word里面弄一个表格后上面的标题会跑到下面怎么办
PHP中文网 06-20 -
Android 11 保存文件到外部存储,并分享文件
Luke 10-12 -
photoshop扩展功能面板显示灰色怎么办
PHP中文网 06-14 -
微信公众号没有声音提示怎么办
PHP中文网 03-31 -
excel下划线不显示怎么办
PHP中文网 06-23 -
excel打印预览压线压字怎么办
PHP中文网 06-22 -
TikTok加速器哪个好免费的TK加速器推荐
TK小达人 10-01 -
怎样阻止微信小程序自动打开
PHP中文网 06-13