Como dividir uma classe em classes parciais (Designer de Classe)

Você pode dividir a declaração de uma classe ou estrutura entre diversas declarações usando a Partial palavra-chave em Visual Basic ou o partial palavra-chave no Visual C#. Você pode usar declarações parciais de tantas quantas desejar, nos arquivos de origem diferentes quantas desejar, ou no mesmo arquivo de origem. No entanto, todas as declarações devem estar no mesmo assembly e o mesmo namespace.

Classes parciais são úteis em várias situações. Por exemplo, quando você estiver trabalhando em projetos grandes, a separação de uma classe em mais de um arquivo permite que mais de um programador trabalhar ao mesmo tempo. Quando você estiver trabalhando com o código que gera a Visual Studio, você pode alterar a classe sem ter que recriar o arquivo de origem. (Código que gera a Visual Studio de exemplos de código de wrapper Windows Forms e Web Service.) Assim, você pode criar o código que usa classes geradas automaticamente, sem ter que modificar o arquivo que cria a Visual Studio.

Existem dois tipos de métodos parciais. No Visual C#, eles são chamados de declaração e implementação; no Visual Basic, eles são chamados de declaração e implementação.

O Class Designer oferece suporte a métodos e classes parciais. A forma de tipo no diagrama de classes se refere a uma localização única declaração da classe parcial. Se a classe parcial é definida em vários arquivos, você pode especificar em qual local de declaração Class Designer usará, definindo a Novo membro local propriedade no Propriedades janela. Ou seja, quando você clica duas vezes uma forma classe, Class Designer vai para o arquivo de origem que contém a declaração da classe identificada pelo Nova localização do membro propriedade. Quando você clica duas vezes um método parcial em uma forma de classe, o Class Designer vai para a declaração de método parcial. Além disso, no Propriedades janela, o Nome do arquivo propriedade refere-se para o local de declaração. Para classes parciais, Nome do arquivo lista todos os arquivos que contêm código de declaração e implementação para essa classe. No entanto, para os métodos parciais, Nome do arquivo lista o arquivo que contém a declaração de método parcial.

Os exemplos a seguir dividir a definição da classe Employee em duas declarações, cada um deles define um procedimento diferente. As duas definições parciais nos exemplos poderiam ser no mesmo arquivo de origem ou em dois arquivos de origem diferente.

Dica

Visual Basic usa definições de classe parcial para separar Visual Studio — gerou o código do código de usuário criado.O código é separado em arquivos de origem distintos.Por exemplo, Designer Windows Form define classes para controles, como Form parciais.Você não deve modificar o código gerado nesses controles.

Para obter mais informações sobre tipos parciais em Visual Basic, consulte Parcial (Visual Basic).

Exemplo

Para dividir uma definição de classe Visual Basic, use o Partial palavra-chave, como mostrado no exemplo a seguir.

' First part of class definition.
Partial Public Class Employee
    Public Sub CalculateWorkHours()
    End Sub
End Class

' Second part of class definition.
Partial Public Class Employee
    Public Sub CalculateTaxes()
    End Sub
End Class

Para dividir uma definição de classe no Visual C#, use o partial palavra-chave, como 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()
    {
    }
}

Consulte também

Referência

Classes e métodos partial (Guia de Programação em C#)

partial (tipo) (Referência de C#)

partial (método) (Referência de C#)

Parcial (Visual Basic)