Partager via

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

  • Article

Mise à jour : novembre 2007

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 (Visual Basic) ou Classes et méthodes partielles (Guide de programmation C#).)

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 Concepteur de DataSet). 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.

Remarque :

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.
Remarque :

Le Concepteur de DataSet 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 Concepteur de DataSet).

  2. Double-cliquez sur le fichier .xsd pour ouvrir le Concepteur de DataSet.

  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

Tâches

Comment : ajouter du code aux TableAdapters dans des applications multicouches

Concepts

Vue d'ensemble de l'application de données multicouche

Vue d'ensemble de TableAdapterManager

Vue d'ensemble de la mise à jour hiérarchique

Vue d'ensemble des groupes de données dans Visual Studio

Autres ressources

TableAdapters

Création d'applications de données clientes