Partial (Visual Basic)

  • Article

Mise à jour : novembre 2007

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.

Remarque :

Visual Basic 2008 introduit des méthodes partielles à utiliser dans des classes partielles. Pour plus d'informations, consultez Méthodes partielles 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 }

Éléments

  • attrlist
    Facultatif. Liste des attributs qui s'appliquent à cette classe ou structure. Vous devez placer la Liste d'attributs 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.

  • MustInherit
    Facultatif. Consultez MustInherit.

  • NotInheritable
    Facultatif. Consultez NotInheritable.

  • name
    Requis. 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.

  • typelist
    Requis si vous utilisez De. Consultez Liste de types.

  • 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.

    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.

Voir aussi

Tâches

Comment : créer une méthode partielle (Visual Basic)

Concepts

Promotion de type

Types génériques en Visual Basic

Méthodes partielles

Référence

Class, instruction (Visual Basic)

Structure, instruction

Shadows