Partager via

Étendre les fonctionnalités d’un TableAdapter dans les applications .NET Framework

Remarque

La DataSet classe et les classes associées sont des technologies .NET Framework héritées du début des années 2000 qui permettent aux applications d’utiliser des données en mémoire pendant que les applications sont déconnectées de la base de données. Les technologies sont particulièrement utiles pour les applications qui permettent aux utilisateurs de modifier les données et de conserver les modifications apportées à la base de données. Bien que les jeux de données soient une technologie éprouvée, l’approche recommandée pour les nouvelles applications .NET consiste à utiliser Entity Framework Core. Entity Framework offre un moyen plus naturel d’utiliser des données tabulaires en tant que modèles objet et dispose d’une interface de programmation plus simple.

Vous pouvez étendre les fonctionnalités d’un TableAdapter en ajoutant du code au fichier de classe partielle de TableAdapter.

Le code qui définit un TableAdapter est régénéré quand des modifications sont apportées à TableAdapter dans le Concepteur de jeux de données ou lorsqu’un Assistant modifie la configuration d’un TableAdapter. Pour empêcher la suppression de votre code pendant la régénération d’un TableAdapter, ajoutez du code au fichier de classe partielle de TableAdapter.

Les classes partielles permettent de diviser le code d’une classe spécifique entre plusieurs fichiers physiques. Pour plus d’informations, consultez Partial ou partial (type).

Localiser TableAdapters dans le code

Bien que TableAdapters soit conçu avec le Concepteur de jeux de données, les classes TableAdapter générées ne sont pas des classes imbriquées de .DataSet Les TableAdapters se trouvent dans un espace de noms basé sur le nom de l'ensemble de données associé aux TableAdapters. Par exemple, si votre application contient un jeu de données nommé HRDataSet, les TableAdapters se trouvent dans l’espace de noms HRDataSetTableAdapters. (La convention d’affectation de noms suit ce modèle : DatasetName + TableAdapters).

L’exemple suivant suppose qu’un TableAdapter nommé CustomersTableAdapter se trouve dans un projet avec NorthwindDataSet.

Pour créer une classe partielle pour un TableAdapter

  1. Ajoutez une nouvelle classe à votre projet en accédant au menu Projet et en sélectionnant Ajouter une classe.

  2. Nommez la classe CustomersTableAdapterExtended.

  3. Sélectionnez Ajouter.

  4. Remplacez le code par l’espace de noms correct et le nom de classe partielle de votre projet comme suit :

    namespace NorthwindDataSetTableAdapters
{
    public partial class CustomersTableAdapter
    {
        // Add user code here. For example:
        public override string ToString()
        {
            return "Overridden in the partial class.";
        }
    }
}

Contenu connexe

  • Last updated on