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

Mise à jour : novembre 2007

Les méthodes partielles permettent aux développeurs d'insérer une logique personnalisée dans le code généré par le concepteur, souvent en vue de validation des données. Une méthode partielle se déroule en deux temps : la définition de la signature de méthode et l'écriture de l'implémentation. En général, la définition est écrite par le concepteur d'un générateur de code, et l'implémentation est écrite par un développeur qui utilise le code généré. Pour plus d'informations, consultez Méthodes partielles.

Pour définir la signature de méthode

  1. Dans une classe partielle, commencez la signature par le mot clé Partial.

  2. Utilisez Private comme modificateur d'accès.

  3. Ajoutez le mot clé Sub. La méthode doit être une procédure Sub.

  4. Écrivez le nom de la méthode.

  5. Fournissez la liste de paramètres de la méthode.

  6. Terminez la méthode par End Sub.

Pour implémenter la méthode

  1. Utilisez Private comme modificateur d'accès.

  2. Ajoutez les autres modificateurs à inclure.

  3. Écrivez le nom de la méthode, qui doit correspondre au nom dans la définition de signature.

  4. Ajoutez la liste de paramètres. Les noms de paramètres doivent correspondre aux noms figurant dans la signature. Les types de données de paramètres peuvent être omis.

  5. Définissez le corps de la méthode.

  6. Terminez par une instruction End Sub.

Exemple

La définition et l'implémentation d'une méthode partielle se trouvent en général dans des fichiers séparés, créés en utilisant une classe partielle. En général, le but d'une méthode partielle est de faire savoir que le projet a été modifié.

Dans l'exemple suivant, une méthode partielle nommée OnNameChanged est développée et appelée. La signature de méthode est définie dans la classe partielle Customer du fichier Customer.Designer.vb. L'implémentation se trouve dans la classe partielle Customer dans le fichier Customer.vb, et une instance de Customer est créée dans un projet utilisant cette classe.

Le résultat est une zone de message qui contient le texte suivant :

Name was changed to: Blue Yonder Airlines.

' File Customer.Designer.vb provides a partial class definition for
' Customer, which includes the signature for partial method 
' OnNameChanged.
Partial Class Customer
    Private _Name As String
    Property Name() As String
        Get
            Return _Name
        End Get
        Set(ByVal value As String)
            _Name = value
            OnNameChanged()
        End Set
    End Property

    ' Definition of the partial method signature.
    Partial Private Sub OnNameChanged()

    End Sub
End Class
' In a separate file, a developer who wants to use the partial class
' and partial method fills in an implementation for OnNameChanged.
Partial Class Customer

    ' Implementation of the partial method.
    Private Sub OnNameChanged()
        MsgBox("Name was changed to " & Me.Name)
    End Sub
End Class
Module Module1

    Sub Main()
        ' Creation of cust will invoke the partial method.
        Dim cust As New Customer With {.Name = "Blue Yonder Airlines"}
    End Sub
End Module

Voir aussi

Concepts

Méthodes partielles

Référence

Partial (Visual Basic)