Partager via

Comment : étendre les fonctionnalités d'un TableAdapter

  • Article

 

Date de publication : mars 2016

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

Le code qui définit un TableAdapter est régénéré lorsque des modifications sont apportées au TableAdapter (dans le Concepteur de Dataset) ou lorsque des modifications sont apportées lors de l'exécution d'un 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 dernier.

(Les classes partielles permettent la répartition du code pour une classe spécifique parmi plusieurs fichiers physiques. Pour plus d'informations, consultez Partial ou partiel, Type.)

Localisation de TableAdapters dans le code

Alors que les TableAdapters sont créés à l'aide du Concepteur de DataSet, les classes TableAdapter générées ne sont pas créées en tant que classes imbriquées du DataSet. Les TableAdapters se trouvent dans un espace de noms basé sur le nom du groupe de données associé du TableAdapter. Par exemple, si votre application contient un groupe 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 : NomGroupeDonnées + TableAdapters).

L'exemple suivant suppose un TableAdapter nommé CustomersTableAdapter dans un projet avec un NorthwindDataSet.

Pour créer une classe partielle pour un TableAdapter

  1. Ajoutez une nouvelle classe à votre projet en sélectionnant Ajouter une classe dans le menu Projet.

  2. Nommez la classe CustomersTableAdapterExtended.

  3. Cliquez sur Ajouter.

  4. Remplacez le code par l'espace de noms adéquat et le nom de classe partiel de votre projet. Par exemple :

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

    Namespace NorthwindDataSetTableAdapters

    Partial Class CustomersTableAdapter

        ' Add user code here. For example:
        Public Overrides Function ToString() As String
            Return "Overridden in the partial class."
        End Function
    End Class
End Namespace

Voir aussi

Vue d'ensemble de TableAdapter
Comment : créer des TableAdapters
Comment : créer des requêtes TableAdapter
Comment : étendre les fonctionnalités d'un groupe de données
Procédures pas à pas relatives aux données
Liaison de contrôles Windows Forms à des données dans Visual Studio
Vue d'ensemble d'applications de données dans Visual Studio
Connexion aux données dans Visual Studio
Préparation de votre application pour recevoir des données
Extraction de données dans votre application
Liaison de contrôles à des données dans Visual Studio
Modification des données dans votre application
Validation des données
Enregistrement des données