Partial (Visual Basic)

Article
06/08/2015

Indique qu'une classe ou une déclaration de structure est une définition partielle de la classe ou de la structure.

Vous pouvez diviser la définition d'une classe ou d'une structure en plusieurs déclarations à l'aide du mot clé Partial. 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 même espace de noms.

Notes

Visual Basic prend en charge les méthodes partielles, qui sont généralement implémentées dans des classes partielles.Pour plus d'informations, consultez Méthodes partielles (Visual Basic) et Sub, instruction (Visual Basic).

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

Composants

Terme	Définition
attrlist	Facultatif. Liste des attributs qui s'appliquent à cette classe ou structure. Vous devez placer la Liste d'attributs (Visual Basic) entre signes "inférieur à" et "supérieur à" (< >).
accessmodifier	Facultatif. Spécifie le code pouvant accéder à cette classe ou structure. Consultez Niveaux d'accès dans Visual Basic.
Shadows	Facultatif. Consultez Shadows (Visual Basic).
MustInherit	Facultatif. Consultez MustInherit (Visual Basic).
NotInheritable	Facultatif. Consultez NotInheritable (Visual Basic).
name	Obligatoire. Nom de cette classe ou structure. Doit correspondre au nom défini dans toutes les autres déclarations partielles de la même classe ou structure.
Of	Facultatif. Spécifie qu'il s'agit d'une classe ou structure générique. Consultez Types génériques en Visual Basic (Visual Basic).
typelist	Requis si vous utilisez De. Consultez Liste de types (Visual Basic).
Inherits	Facultatif. Consultez Inherits, instruction.
classname	Requis si vous utilisez Inherits. Nom de la classe ou interface dont cette classe dérive.
Implements	Facultatif. Consultez Implements, instruction.
interfacenames	Requis si vous utilisez Implements. Noms des interfaces que cette classe ou structure implémente.
variabledeclarations	Facultatif. Instructions qui déclarent des variables et des événements supplémentaires pour la classe ou la structure.
proceduredeclarations	Facultatif. Instructions qui déclarent et définissent des procédures supplémentaires pour la classe ou la structure.
End Class ou End Structure	Termine la définition partielle de Class de Structure.

Notes

Visual Basic utilise des définitions de classe partielle pour séparer le code généré du code utilisateur créé dans des fichiers sources séparés. 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 pour la création de classe et de structure, telles que celles pour l'utilisation et l'héritage de modificateur, s'appliquent lors de la création d'une classe ou d'une structure partielle.

Meilleures pratiques

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

Comportement

Union de déclarations. Le compilateur traite la classe ou structure comme l'union de toutes ses déclarations partielles. Chaque modificateur de chaque définition partielle s'applique à la classe ou structure entière et chaque membre de chaque définition partielle est disponible pour la classe ou structure entière.
Promotion de type non autorisée pour les types partiels dans les modules. Si une définition partielle se trouve dans un module, la promotion de type de cette classe ou structure est automatiquement annulée. Dans un tel cas, un jeu de définitions partielles peut provoquer des résultats inattendus ainsi que des erreurs du compilateur. Pour plus d'informations, consultez Promotion de type (Visual Basic).

Le compilateur fusionne des définitions partielles uniquement lorsque leurs chemins qualifiés complets sont identiques.

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

Class, instruction

Structure, instruction

Exemple

L'exemple suivant fractionne la définition de sampleClass de classe en deux déclarations chacune d'elles définit une procédure Sub différente.

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 dans l'exemple précédent pourraient se trouver dans le même fichier source ou dans deux fichiers sources différents.