Type partiel (Référence C#)

Les définitions de type partiel vous permettent de fractionner la définition d’une classe, d’un struct, d’une interface ou d’un enregistrement en plusieurs définitions. Vous pouvez placer ces plusieurs définitions dans différents fichiers au sein du même projet. Une déclaration de type contient uniquement les signatures pour les membres partiels :

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

L’autre déclaration contient l’implémentation des membres partiels :

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

Les déclarations pour un type partiel peuvent apparaître soit dans le même fichier, soit dans des fichiers différents. En général, les deux déclarations se trouvent dans des fichiers différents. Vous fractionnez une classe, un struct ou un type d’interface lorsque vous travaillez avec des projets volumineux, avec du code généré automatiquement, tel que celui fourni par le Concepteur Windows Forms ou des générateurs sources tels que RegEx. Un type partiel peut contenir des membres partiels.

La documentation de référence du langage C# décrit la version la plus récente du langage C#. Il contient également la documentation initiale des fonctionnalités dans les préversions publiques pour la prochaine version du langage.

La documentation identifie toute fonctionnalité introduite en premier dans les trois dernières versions de la langue ou dans les préversions publiques actuelles.

Conseil / Astuce

Pour savoir quand une fonctionnalité a été introduite en C#, consultez l’article sur l’historique des versions du langage C#.

À compter de C# 13, vous pouvez définir des propriétés partielles et des indexeurs partiels. À compter de C# 14, vous pouvez définir des constructeurs d’instances partielles et des événements partiels. Avant C# 13, seules les méthodes pouvaient être définies en tant que membres partiels.

Vous pouvez fournir des commentaires de documentation sur la déclaration déclarante ou la déclaration d’implémentation. Lorsque vous appliquez des commentaires de documentation aux deux déclarations de type, les éléments XML de chaque déclaration sont inclus dans le code XML de sortie. Pour connaître les règles relatives aux déclarations de membres partiels, consultez l’article sur les membres partiels.

Vous pouvez appliquer des attributs à l’une ou l’autre déclaration. Le compilateur combine tous les attributs des deux déclarations, y compris les doublons.

Pour plus d’informations, consultez la page Classes et méthodes partielles.

spécification du langage C#

Pour plus d'informations, voir la spécification du langage C#. La spécification du langage est la source de référence pour la syntaxe C# et son utilisation.

Voir aussi

• Modificateurs
• Introduction aux génériques