分部类跨越多个文件。

如何在c#类声明中使用分部修饰符?

使用部分类，您可以将一个类物理地分离到多个文件中。这通常由代码生成器完成。

例子

对于普通的c#类，您不能在同一个项目中的两个独立文件中声明一个类。但是对于部分修饰语，你可以。

如果一个文件经常被编辑，而另一个文件是机器生成的或很少被编辑，这是很有用的。

这里有一个例子来说明:

class Program
{
    static void Main()
    {
        A.A1();
        A.A2();
    }
}

A1.cs文件内容:c#

using System;

partial class A
{
    public static void A1()
    {
        Console.WriteLine("A1");
    }
}

A2.cs文件内容:c#

using System;

partial class A
{
    public static void A2()
    {
        Console.WriteLine("A2");
    }
}

输出:

A1
A2

这里需要Partial。

如果你删除了部分修饰符，你将得到一个包含以下文本的错误:

[命名空间'<全局命名空间>'已经包含' a '的定义]。

Tip:

要解决这个问题，可以使用partial关键字，或者更改其中一个类名。

c#编译器如何处理部分类?

如果你分解上面的程序(使用IL Disassembler)，你会看到文件A1.cs和A2.cs被删除了。你会发现A类出现了。

类A将在同一个代码块中包含方法A1和A2。这两个班合并为一个班。

A1.cs和A2.cs的编译结果:c#

internal class A
{
    // Methods
    public static void A1()
    {
        Console.WriteLine("A1");
    }

    public static void A2()
    {
        Console.WriteLine("A2");
    }
}

总结

部分类可以简化某些c#编程情况。 当创建Windows窗体/WPF程序时，通常在Visual Studio中使用它们。 机器生成的c#代码是独立的。 或者你可以在这里找到完整的描述。

一个很好的用法是将生成的代码与属于同一类的手写代码分离。

例如，由于LINQ to SQL使用部分类，您可以编写自己的某些功能片段的实现(如多对多关系)，并且当您重新生成代码时，这些自定义代码片段不会被覆盖。

WinForms代码也是如此。所有设计器生成的代码都放在一个文件中，您通常不会接触这个文件。手写的代码放到另一个文件中。这样，当您在设计器中更改某些内容时，您所做的更改不会被影响。

分部类的主要用途是生成代码。如果你看看WPF (Windows Presentation Foundation)网络，你用标记(XML)定义你的UI。该标记被编译成部分类。您可以用自己的部分类填充代码。

通过部分类，只需添加源文件，就可以向适当设计的程序添加功能。例如，可以设计一个文件导入程序，这样就可以通过添加处理文件的模块来添加不同类型的已知文件。例如，主文件类型转换器可以包含一个小类:

Partial Public Class zzFileConverterRegistrar
    Event Register(ByVal mainConverter as zzFileConverter)
    Sub registerAll(ByVal mainConverter as zzFileConverter)
        RaiseEvent Register(mainConverter)
    End Sub
End Class

每个希望注册一个或多个类型的文件转换器的模块可以包括如下内容:

Partial Public Class zzFileConverterRegistrar
    Private Sub RegisterGif(ByVal mainConverter as zzFileConverter) Handles Me.Register
        mainConverter.RegisterConverter("GIF", GifConverter.NewFactory))
    End Sub
End Class

注意，主文件转换器类并没有“公开”——它只是公开了一个小存根类，外接程序模块可以钩子到这个存根类。存在命名冲突的轻微风险，但如果每个外接程序模块的“寄存器”例程是根据它处理的文件类型命名的，那么它们可能不会造成问题。如果担心这样的事情，可以在注册子例程的名称中插入GUID。

Edit/Addendum To be clear, the purpose of this is to provide a means by which a variety of separate classes can let a main program or class know about them. The only thing the main file converter will do with zzFileConverterRegistrar is create one instance of it and call the registerAll method which will fire the Register event. Any module that wants to hook that event can execute arbitrary code in response to it (that's the whole idea) but there isn't anything a module could do by improperly extending the zzFileConverterRegistrar class other than define a method whose name matches that of something else. It would certainly be possible for one improperly-written extension to break another improperly-written extension, but the solution for that is for anyone who doesn't want his extension broken to simply write it properly.

在不使用分部类的情况下，可以在主文件转换器类的某个地方写一些代码，如下所示:

  RegisterConverter("GIF", GifConvertor.NewFactory)
  RegisterConverter("BMP", BmpConvertor.NewFactory)
  RegisterConverter("JPEG", JpegConvertor.NewFactory)

但是添加另一个转换器模块需要进入转换器代码的那一部分，并将新的转换器添加到列表中。使用partial方法，这就不再需要了——所有转换器都会自动包含。

部分类的最大用途是使代码生成器/设计人员的工作更轻松。部分类允许生成器简单地发出它们需要发出的代码，而不需要处理用户对文件的编辑。用户同样可以通过创建第二个分部类来自由地用新成员注释类。这为关注点分离提供了一个非常清晰的框架。

更好的方法是看看设计器在部分类之前是如何工作的。WinForms设计器会吐出区域内的所有代码，并给出不修改代码的强烈注释。它必须插入各种启发式方法来找到生成的代码，以便稍后进行处理。现在它可以简单地打开designer.cs文件，并有高度的信心它只包含与设计器相关的代码。

下面列出了部分类的一些优点。

您可以分离UI设计代码和业务逻辑代码，以便易于阅读和理解。例如，你正在使用Visual Studio开发一个web应用程序，并添加一个新的web表单，然后有两个源文件，“aspx.cs”和“aspx.designer.cs”。这两个文件具有具有partial关键字的相同类。".aspx.cs"类有业务逻辑代码，而"aspx.designer.cs"有用户界面控件定义。

When working with automatically generated source, the code can be added to the class without having to recreate the source file. For example you are working with LINQ to SQL and create a DBML file. Now when you drag and drop a table it creates a partial class in designer.cs and all table columns have properties in the class. You need more columns in this table to bind on the UI grid but you don't want to add a new column to the database table so you can create a separate source file for this class that has a new property for that column and it will be a partial class. So that does affect the mapping between database table and DBML entity but you can easily get an extra field. It means you can write the code on your own without messing with the system generated code.

多个开发人员可以同时为类编写代码。

压缩大型类可以更好地维护应用程序。假设您有一个具有多个接口的类，因此您可以根据接口实现创建多个源文件。理解和维护源文件具有部分类的接口是很容易的。