Share via

Comment : ajouter du code aux TableAdapters dans des applications multicouches

  • Article

Mise à jour : novembre 2007

Vous pouvez étendre les fonctionnalités d'un TableAdapter en créant un fichier de classe partielle pour le TableAdapter et en y ajoutant le code (au lieu d'ajouter le code au fichier NomGroupeDonnées.DataSet.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 partiel, Type (Référence C#).)

Le code qui définit un TableAdapter est généré à chaque fois que des modifications sont apportées au TableAdapter (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 TableAdapter. Pour empêcher la suppression de votre code pendant la régénération d'un TableAdapter, ajoutez le code au fichier de classe partielle de ce TableAdapter.

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

Il est possible que votre ordinateur affiche des noms ou des emplacements différents pour certains des éléments d'interface utilisateur Visual Studio dans les instructions suivantes. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments. Pour plus d'informations, consultez Paramètres Visual Studio.

Pour ajouter le code utilisateur à un TableAdapter dans une application multicouche

  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 le TableAdapter auquel vous souhaitez ajouter le code 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.

  5. L'exemple de code suivant indique où le code doit être ajouté dans le CustomersTableAdapter du NorthwindDataSet :

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

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

Voir aussi

Tâches

Comment : ajouter du code aux groupes de données 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

Autres ressources

TableAdapters

Création d'applications de données clientes