在类设计器中将类拆分为分部类

可以使用 partial 关键字(Visual Basic 中的 Partial)来划分类声明或多个声明中的结构。 可以使用任意数量的部分声明。

这些声明可在一个或多个源文件中。 所有声明都必须在相同的程序集和相同的命名空间中。

分部类在以下几种情况下有用。 例如,在大型项目中,可通过将一个类分成多个文件来让多名程序员同时处理该项目。 在使用 Visual Studio 生成的代码时,可在无需重新创建源文件的情况下更改类。 (Visual Studio 生成的代码的示例包括 Windows 窗体和 Web 服务包装器代码。)因此,无需修改 Visual Studio 创建的文件,就可以创建使用自动生成的类的代码。

有两种分部方法。 在 C# 中,它们被称为 declaring 和 implementing;而在 Visual Basic 中,它们被称为 declaration 和 implementation。

类设计器支持分部类和方法。 类图中的类型形状是指分部类的单个声明位置。 如果分部类在多个文件中定义,则可以通过在“属性”窗口中设置“New Member Location”属性来指定将要使用的声明位置类设计器。 也就是说,双击类形状时,类设计器就会转到包含由“New Member Location”属性标识的类声明的源文件。 双击类形状中的分部方法时,类设计器会转到分部方法声明。 此外,在“属性”窗口中,“File Name”属性是指声明位置。 对于分部类,“File Name”列出包含该类的声明和实现代码的所有文件。 但是,对于分部方法,“File Name”仅列出包含分部方法声明的文件。

下面的示例将类 Employee 的定义拆分到两个声明中,其中每一个均定义一个不同的过程。 示例中的两个分部定义可能在一个源文件中或在两个不同的源文件中。

注意

Visual Basic 使用分部类定义将 Visual Studio 生成的代码与用户编写的代码分开。 代码被分成单独的源文件。 例如,“Windows 窗体设计器”定义了控件的分部类,如 Form。 不应修改这些控件中生成的代码。

有关 Visual Basic 中分部类型的详细信息,请参阅分部

示例

若要拆分类定义,请使用 partial 关键字(Visual Basic 中的 Partial),如以下示例所示:

// First part of class definition.
public partial class Employee
{
    public void CalculateWorkHours()
    {
    }
}

// Second part of class definition.
public partial class Employee
{
    public void CalculateTaxes()
    {
    }
}