Partiel (Visual Basic)

2025-07-31

Indique qu’une déclaration de type est une définition partielle du type.

Vous pouvez diviser la définition d’un type entre plusieurs déclarations à l’aide du Partial mot clé. Vous pouvez utiliser autant de déclarations partielles que vous le souhaitez, dans autant de fichiers sources différents que vous le souhaitez. Toutefois, toutes les déclarations doivent se trouver dans le même assembly et dans le même espace de noms.

Remarque

Visual Basic prend en charge les méthodes partielles, généralement implémentées dans des classes partielles. Pour plus d’informations, consultez Méthodes partielles et sous-instruction.

Syntaxe

[ <attrlist> ] [ accessmodifier ] [ Shadows ] [ MustInherit | NotInheritable ] _  
Partial { Class | Structure | Interface | Module } name [ (Of typelist) ]  
    [ Inherits classname ]  
    [ Implements interfacenames ]  
    [ variabledeclarations ]  
    [ proceduredeclarations ]  
{ End Class | End Structure }

Pièces

Terme	Définition
`attrlist`	Optionnel. Liste des attributs qui s’appliquent à ce type. Vous devez placer la liste d’attributs entre crochets (`< >`).
`accessmodifier`	Optionnel. Spécifie le code qui peut accéder à ce type. Consultez les niveaux d’accès en Visual Basic.
`Shadows`	Optionnel. Voir Ombres.
`MustInherit`	Optionnel. Voir MustInherit.
`NotInheritable`	Optionnel. Voir NotInheritable.
`name`	Obligatoire. Nom de ce type. Doit correspondre au nom défini dans toutes les autres déclarations partielles du même type.
`Of`	Optionnel. Spécifie qu’il s’agit d’un type générique. Consultez les types génériques en Visual Basic.
`typelist`	Obligatoire si vous utilisez Of. Consultez La liste des types.
`Inherits`	Optionnel. Voir l’instruction Inherits.
`classname`	Obligatoire si vous utilisez `Inherits`. Nom de la classe ou de l’interface à partir de laquelle cette classe dérive.
`Implements`	Optionnel. Consultez l’instruction Implements.
`interfacenames`	Obligatoire si vous utilisez `Implements`. Noms des interfaces que ce type implémente.
`variabledeclarations`	Optionnel. Instructions qui déclarent des variables et des événements supplémentaires pour le type.
`proceduredeclarations`	Optionnel. Instructions qui déclarent et définissent des procédures supplémentaires pour le type.
`End Class` ou `End Structure`	Termine cette définition partielle ou `Structure` partielle`Class`.

Remarques

Visual Basic utilise des définitions de classe partielle pour séparer le code généré du code créé par l’utilisateur dans des fichiers sources distincts. Par exemple, le Concepteur Windows Form définit des classes partielles pour les contrôles tels que Form. Vous ne devez pas modifier le code généré dans ces contrôles.

Toutes les règles de création de classes, de structure, d’interface et de module, telles que celles pour l’utilisation des modificateurs et l’héritage, s’appliquent lors de la création d’un type partiel.

Meilleures pratiques

Dans des circonstances normales, vous ne devez pas fractionner le développement d’un type unique sur deux déclarations ou plus. Par conséquent, dans la plupart des cas, vous n’avez pas besoin du Partial mot clé.
Pour une lisibilité, chaque déclaration partielle d’un type doit inclure le Partial mot clé. Le compilateur permet au plus une déclaration partielle d’omettre le mot clé ; si deux ou plusieurs l’omettent, le compilateur signale une erreur.

Comportement

Union de déclarations. Le compilateur traite le type comme l’union de toutes ses déclarations partielles. Chaque modificateur de chaque définition partielle s’applique à l’ensemble du type, et chaque membre de chaque définition partielle est disponible pour l’ensemble du type.
Promotion de type non autorisée pour les types partiels dans les modules. Si une définition partielle se trouve à l’intérieur d’un module, la promotion de type de ce type est automatiquement vaincue. Dans ce cas, un ensemble de définitions partielles peut entraîner des résultats inattendus et même des erreurs du compilateur. Pour plus d’informations, consultez Promotion de type.

Le compilateur fusionne les définitions partielles uniquement lorsque leurs chemins complets sont identiques.

Le Partial mot clé peut être utilisé dans ces contextes :

Déclaration de classe

Déclaration de structure

Exemple :

L’exemple suivant fractionne la définition de la classe sampleClass en deux déclarations, chacune définissant une procédure différente Sub .

Partial Public Class sampleClass
    Public Sub sub1()
    End Sub
End Class
Partial Public Class sampleClass
    Public Sub sub2()
    End Sub
End Class

Les deux définitions partielles de l’exemple précédent peuvent se trouver dans le même fichier source ou dans deux fichiers sources différents.

Partager via