Tipo parcial (Referência C#)

Definições parciais de tipos permitem-lhe dividir a definição de uma classe, estrutura, interface ou registo em múltiplas definições. Pode colocar estas múltiplas definições em diferentes ficheiros dentro do mesmo projeto. Uma declaração de tipo contém apenas as assinaturas para membros parciais:

partial class A
{
    int num = 0;
    void MethodA() { }
    partial void MethodC();
}

A outra declaração contém a implementação dos membros parciais:

partial class A
{
    void MethodB() { }
    partial void MethodC() { }
}

As declarações para um tipo parcial podem aparecer no mesmo arquivo ou em vários arquivos. Normalmente, as duas declarações estão em arquivos diferentes. Você divide uma classe, struct ou tipo de interface quando está trabalhando com projetos grandes, com código gerado automaticamente, como o fornecido pelo Windows Forms Designer, ou geradores de código-fonte como RegEx. Um tipo parcial pode conter membros parciais.

A referência da linguagem C# documenta a versão mais recentemente lançada da linguagem C#. Contém também documentação inicial para funcionalidades em versões preliminares públicas para a próxima versão da linguagem.

A documentação identifica qualquer funcionalidade introduzida pela primeira vez nas últimas três versões da língua ou em pré-visualizações públicas atuais.

Sugestão

Para saber quando uma funcionalidade foi introduzida pela primeira vez em C#, consulte o artigo sobre o histórico de versões da linguagem C#.

Começando por C#13, pode definir propriedades parciais e indexadores parciais. Começando com C# 14, podes definir construtores parciais de instância e eventos parciais. Antes do C# 13, apenas os métodos podiam ser definidos como membros parciais.

Pode fornecer comentários documentais tanto na declaração de declaração como na declaração de implementação. Quando aplica comentários de documentação a ambas as declarações de tipos, os elementos XML de cada declaração são incluídos no XML de saída. Para as regras sobre declarações de membros parciais, consulte o artigo sobre membros parciais.

Você pode aplicar atributos a qualquer declaração. O compilador combina todos os atributos de ambas as declarações, incluindo duplicados.

Para obter mais informações, consulte Classes e métodos parciais.

Especificação da linguagem C#

Para obter mais informações, consulte a Especificação da linguagem C#. A especificação da linguagem é a fonte definitiva para a sintaxe e o uso do C#.

Consulte também

• Modificadores
• Introdução aos Genéricos