首页 > 代码库 > C# partial 说明

C# partial 说明

1. 什么是局部类型?

C# 2.0 引入了局部类型的概念。局部类型同意我们将一个类、结构或接口分成几个部分,分别实如今几个不同的.cs文件里。

局部类型适用于下面情况:

(1) 类型特别大,不宜放在一个文件里实现。
(2) 一个类型中的一部分代码为自己主动化工具生成的代码,不宜与我们自己编写的代码混合在一起。
(3) 须要多人合作编写一个类。

局部类型是一个纯语言层的编译处理,不影响不论什么运行机制——其实C#编译器在编译的时候仍会将各个部分的局部类型合并成一个完整的类。

   public partial class Program
   {
     static void Main(string[] args)
     {
     }
   }

   partial class Program
   { 
     public void Test()
     { 
     }
   }


2. 局部类型的限制

(1) 局部类型仅仅适用于类、接口、结构,不支持托付和枚举。
(2) 同一个类型的各个部分必须都有修饰符 partial。
(3) 使用局部类型时,一个类型的各个部分必须位于同样的命名空间中。
(4) 一个类型的各个部分必须被同一时候编译。

3. 局部类型的注意点

(1) keywordpartial是一个上下文keyword,仅仅有和 class、struct、interface 放在一起时才有keyword的含义。因此partial的引入不会影响现有代码中名称为partial的变量。
(2) 局部类型的各个部分通常是分开放在几个不同的.cs文件里,但C#编译器同意我们将他们放在同一文件里。

4. 局部类型的应用特性

在局部类型上的特性具有“累加”效应。

[Attribute1, Attribute2("Hello")]
partial class Class1{}

[Attribute3, Attribute2("Exit")]
partial class Class1{}


相当于

[Attribute1, Attribute2("Hello"), Attribute3, Attribute2("Exit")]
class Class1 {}


注:Attribute2属性同意在类上多次使用。

5. 局部类型上的修饰符

(1) 一个类型的各个部分上的訪问修饰符必须维持一致性。
(2) 假设一个类型有一个部分使用了abstract修饰符,那么整个类都将被视为抽象类。
(3) 假设一个类型有一个部分使用了 sealed 修饰符,那么整个类都将被视为密封类。
(4) 一个类的各个部分不能使用相互矛盾的修饰符,比方不能在一个部分上使用abstract,又在还有一个部分上使用sealed。

6. 局部类型的基类和接口

(1) 一个类型的各个部分上指定的基类必须一致。某个部分能够不指定基类,但假设指定,则必须同样。
(2) 局部类型上的接口具有“累加”效应。

partial class Class2: Iinterface1, Iinterface2 {}
partial class Class2: Iinterface3 {}
partial class Class2: Iinterface2 {}


相当于

class Class2: Iinterface1, Iinterface2, Iinterface3 {}




把全部的源码作为一个类型保存在一个单独的文件中是一个好的编程习惯,但有时候一个类型变得过于庞大以至于这样做成为一个不切实际的约束。此外,编程人员常常使用源码生成器来产生一个应用程序的初始结构,然后再改动产生的代码。不幸的是,当源码在将来某个时候再次公布时,已存在的改动就要被覆盖了。

 

Partial types同意把类,结构和接口打破为多个代码碎片存在不同的源码文件,以便于简化开发和维护。加之partial types同意机器产生的和用户编写的类型部分分离,这样就能够方便添加工具产生的代码。

 

Partial,是一个新的类型修饰符,在把一个类型定义在多个部分的时候使用。以下是一个partial class的演示样例,以两个部分实现。这两个部分可能在两个不同的源码文件,比方说第一个部分是由一个数据库映射工具产生的,而第二个部分是手工编写的。

public partial class Customer
{
    private int id;
    private string name;
    private string address;
    private List<Order> orders;
    public Customer() {
        
    }
}
public partial class Customer
{
    public void SubmitOrder(Order order) {
        orders.Add(order);
    }
    public bool HasOutstandingOrders() {
        return orders.Count > 0;
    }
}


当上面的两个部分在一起编译,结果产生的代码就好像这个类是写在一个单元里一样。

 

public class Customer
{
    private int id;
    private string name;
    private string address;
    private List<Order> orders;
    public Customer() {
        
    }
    public void SubmitOrder(Order order) {
        orders.Add(order);
    }
    public bool HasOutstandingOrders() {
        return orders.Count > 0;
    }
}


一个partial type的全部部分必须在一起编译,这样全部的部分才干在编译的时候整合在一起。特别的是partial types不同意增加已经编译好的类型。