Dividir uma classe em classes parciais no Designer de Classe
Você pode usar a palavra-chave partial (Partial em Visual Basic) para dividir a declaração de uma classe ou estrutura entre várias declarações. Você pode usar quantas declarações parciais desejar.
As declarações podem estar em um ou em vários arquivos de origem. Todas as declarações precisam estar no mesmo assembly e no mesmo namespace.
Classes parciais são úteis em várias situações. Em um projeto grande, por exemplo, a separação de uma classe em vários arquivos permite que mais de um programador trabalhe no projeto ao mesmo tempo. Quando você está trabalhando com o código que o Visual Studio gera, é possível alterar a classe sem precisar recriar o arquivo de origem. (Exemplos de código gerados pelo Visual Studio incluem Windows Forms e código wrapper do serviço Web.) Assim, você pode criar um código que usa classes geradas automaticamente sem precisar modificar o arquivo que o Visual Studio cria.
Existem dois tipos de métodos parciais. No C#, eles são chamados de declarar e implementar. No Visual Basic, são chamados de declaração e implementação.
O Designer de Classe é compatível com métodos e classes parciais. A forma de tipo no diagrama de classe se refere a um único local de declaração para a classe parcial. Se a classe parcial for definida em vários arquivos, você poderá especificar qual local de declaração o Designer de Classe usará definindo a propriedade Local do Novo Membro na janela Propriedades. Ou seja, quando você clica duas vezes em uma forma de classe, o Designer de Classe vai até o arquivo de origem que contém a declaração de classe identificada pela propriedade Local do Novo Membro. Quando você clica duas vezes em um método parcial em uma forma de classe, o Designer de Classe vai para a declaração de método parcial. Além disso, na janela Propriedades, a propriedade Nome de Arquivo aponta para o local da declaração. Para classes parciais, Nome de Arquivo lista todos os arquivos que contêm código de implementação e declaração dessa classe. No entanto, para métodos parciais, Nome de Arquivo lista apenas o arquivo que contém a declaração de método parcial.
Os exemplos a seguir dividem a definição da classe Employee em duas declarações, cada uma das quais define um procedimento diferente. As duas definições parciais nos exemplos podem estar em um arquivo de origem ou em dois arquivos de origem diferentes.
Observação
O Visual Basic usa definições de classe parcial para separar o código gerado pelo Visual Studio do código de autoria do usuário. O código é separado em arquivos de origem distintos. Por exemplo, o Windows Form Designer define classes parciais para controles, como Form. Você não deve modificar o código gerado nesses controles.
Para obter mais informações sobre tipos parciais no Visual Basic, consulte Parcial.
Exemplo
Para dividir uma definição de classe, use a palavra-chave partial (Partial no Visual Basic), conforme mostrado no exemplo a seguir:
// First part of class definition.
public partial class Employee
{
public void CalculateWorkHours()
{
}
}
// Second part of class definition.
public partial class Employee
{
public void CalculateTaxes()
{
}
}