ExpertiDict

C# · Essencial · Português · Técnico

classe parcial

/ˈkla.si paɾ.ˈsi.aw/substantivo

Classe dividida em vários arquivos com a palavra partial; o compilador junta as partes em um só tipo, o que é comum em código gerado e em Razor.

Onde usar

Aparece quando uma ferramenta gera código, como designers e source generators, e você precisa estender a classe sem editar o arquivo gerado. Todas as partes precisam estar no mesmo assembly e namespace.

Em código

// Pessoa.cs
public partial class Pessoa {
  public string Nome { get; set; } = "";
}
// Pessoa.Extras.cs
public partial class Pessoa {
  public override string ToString() => Nome;
}

Exemplos

Crie uma classe parcial para não mexer no arquivo gerado.

Todas as partes da classe parcial precisam ter o mesmo namespace.

Cuidado

Não use partial para esconder uma classe grande demais: dividir em arquivos não reduz a complexidade.

Sinônimos

partial class

Veja também

Todos os termos de C#