Partager via

Comment : ajouter du code aux groupes de données dans des applications multicouches

  • Article

 

Date de publication : mars 2016

Vous pouvez étendre les fonctionnalités d'un groupe de données en créant un fichier de classe partielle pour le groupe de données et en y ajoutant du code (au lieu d'ajouter du code au fichier NomGroupeDonnéesDataset.Designer). Les classes partielles permettent de répartir du code parmi plusieurs fichiers physiques pour une classe spécifique. Pour plus d'informations, consultez Partial ou Classes et méthodes partielles.)

Le code qui définit un groupe de données est généré à chaque fois que des modifications sont apportées à la définition du groupe de données (dans le Création et modification de Datasets typés). Ce code est également généré lorsque vous apportez des modifications pendant l'exécution de n'importe quel Assistant qui modifie la configuration d'un groupe de données. Pour empêcher la suppression de votre code pendant la régénération d'un groupe de données, ajoutez le code au fichier de classe partielle de ce dernier.

Par défaut, une fois que vous avez séparé le code du groupe de données et le code du TableAdapter, vous obtenez un fichier de classe discret dans chaque projet. Le projet d'origine a un fichier nommé NomGroupeDonnées.Designer.vb (ou NomGroupeDonnées.Designer.cs) qui contient le code du TableAdapter. Le projet désigné dans la propriété Projet DataSet a un fichier nommé NomGroupeDonnées.DataSet.Designer.vb (ou NomGroupeDonnées.DataSet.Designer.cs) qui contient le code du groupe de données.

Notes

Lorsque vous séparez des groupes de données et des TableAdapters (en définissant la propriété Projet DataSet), les classes DataSet partielles existant dans le projet ne sont pas automatiquement déplacées. En effet, ces classes doivent être déplacées manuellement vers le projet DataSet.

Notes

Le Création et modification de Datasets typés propose également des fonctionnalités pour générer les gestionnaires d'événements ColumnChanging et RowChanging lorsque le code de validation doit être ajouté. Pour plus d'informations, consultez Comment : ajouter la validation à un groupe de données multicouche.

Pour ajouter du code aux groupes de données dans des applications multicouches

  1. Localisez le projet qui contient le fichier .xsd (le Création et modification de Datasets typés).

  2. Double-cliquez sur le fichier .xsd pour ouvrir le Création et modification de Datasets typés.

  3. Cliquez avec le bouton droit sur la table de données dans laquelle vous souhaitez ajouter le code (le nom de table dans la barre de titre) et cliquez sur Afficher le code.

    Une classe partielle est créée et s'ouvre dans l'éditeur de code.

  4. Ajoutez le code à l'intérieur de la déclaration de classe partielle.

    L'exemple suivant indique où ajouter le code au CustomersDataTable dans NorthwindDataSet :

    Partial Public Class CustomersDataTable  
    ' Add code here to add functionality   
    ' to the CustomersDataTable.  
End Class  

    partial class CustomersDataTable  
{  
    // Add code here to add functionality  
    // to the CustomersDataTable.  
}

Voir aussi

Vue d'ensemble des applications de données multicouches
Comment : ajouter du code aux TableAdapters dans des applications multicouches
TableAdapters
Vue d'ensemble de TableAdapterManager
Vue d'ensemble de la mise à jour hiérarchique
Création d'applications de données
Utilisation de groupes de données dans Visual Studio