Ajouter du code aux TableAdapters dans des applications multiniveauxAdd code to TableAdapters in n-tier applications

Vous pouvez étendre les fonctionnalités d’un TableAdapter en créant un fichier de classe partielle du TableAdapter et en ajoutant du code (au lieu d’ajouter du code pour le DatasetName.DataSet.Designer fichier).You can extend the functionality of a TableAdapter by creating a partial class file for the TableAdapter and adding code to it (instead of adding code to the DatasetName.DataSet.Designer file). Classes partielles permettent au code pour une classe spécifique être réparti entre plusieurs fichiers physiques.Partial classes enable code for a specific class to be divided among multiple physical files. Pour plus d’informations, consultez partielle ou partial (Type).For more information, see Partial or partial (Type).

Le code qui définit un TableAdapter est généré chaque fois les modifications sont apportées au TableAdapter dans le jeu de données.The code that defines a TableAdapter is generated every time changes are made to the TableAdapter in the dataset. Ce code est également généré lorsque des modifications sont apportées pendant l’exécution d’un Assistant qui modifie la configuration du TableAdapter.This code is also generated when changes are made during the running of any wizard that modifies the configuration of the TableAdapter. Pour empêcher que votre code en cours de suppression pendant la régénération d’un TableAdapter, ajoutez le code au fichier de classe partielle du TableAdapter.To prevent your code from being deleted during the regeneration of a TableAdapter, add code to the partial class file of the TableAdapter.

Par défaut, une fois que vous séparez le jeu de données et le code du TableAdapter, le résultat est un fichier de classe discret dans chaque projet.By default, after you separate the dataset and TableAdapter code, the result is a discrete class file in each project. Le projet d’origine a un fichier nommé NomGroupeDonnées.Designer.vb (ou NomGroupeDonnées.Designer.cs) qui contient le code du TableAdapter.The original project has a file named DatasetName.Designer.vb (or DatasetName.Designer.cs) that contains the TableAdapter code. Le projet désigné dans la Dataset Project propriété dispose d’un fichier nommé NomGroupeDonnées.DataSet.Designer.vb (ou NomGroupeDonnées.DataSet.Designer.cs) qui contient le code de jeu de données.The project that's designated in the Dataset Project property has a file named DatasetName.DataSet.Designer.vb (or DatasetName.DataSet.Designer.cs) that contains the dataset code.

Note

Quand vous séparez les datasets et les TableAdapters (en définissant le DataSet Project propriété), les classes dataset partielles existantes dans le projet ne seront pas être déplacées automatiquement.When you separate datasets and TableAdapters (by setting the DataSet Project property), existing partial dataset classes in the project will not be moved automatically. Les classes dataset partielles existantes doivent être déplacés manuellement dans le projet dataset.Existing partial dataset classes must be moved manually to the dataset project.

Note

Le jeu de données fournit des fonctionnalités de génération ColumnChanging et RowChanging gestionnaires d’événements lorsque la validation est nécessaire.The dataset provides functionality for generating ColumnChanging and RowChanging event handlers when validation is needed. Pour plus d’informations, consultez ajouter la validation à un jeu de données multicouches.For more information, see Add validation to an n-tier dataset.

Note

Il est possible que pour certains des éléments de l’interface utilisateur de Visual Studio, votre ordinateur affiche des noms ou des emplacements différents de ceux indiqués dans les instructions suivantes.Your computer might show different names or locations for some of the Visual Studio user interface elements in the following instructions. L’édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments.The Visual Studio edition that you have and the settings that you use, determine these elements. Pour plus d’informations, consultez Personnaliser l’IDE.For more information, see Personalize the IDE.

Pour ajouter du code de l’utilisateur à un TableAdapter dans une architecture multiniveauTo add user code to a TableAdapter in an n-tier application

  1. Recherchez le projet qui contient le .xsd fichier.Locate the project that contains the .xsd file.

  2. Double-cliquez sur le .xsd fichier à ouvrir le Concepteur de Dataset.Double click the .xsd file to open the Dataset Designer.

  3. Cliquez sur le TableAdapter que vous souhaitez ajouter le code et sélectionnez afficher le Code.Right-click the TableAdapter that you want to add code to, and then select View Code.

    Une classe partielle est créée et s’ouvre dans l’éditeur de Code.A partial class is created and opens in the Code Editor.

  4. Ajoutez le code à l’intérieur de la déclaration de classe partielle.Add code inside the partial class declaration.

  5. L’exemple suivant montre où ajouter le code pour le CustomersTableAdapter dans le NorthwindDataSet:The following example shows where to add code to the CustomersTableAdapter in the 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 aussiSee also