Ampliación de la funcionalidad de tableAdapter en aplicaciones de .NET Framework

Nota:

La DataSet clase y las clases relacionadas son tecnologías heredadas de .NET Framework de principios de los años 2000 que permiten a las aplicaciones trabajar con datos en memoria mientras las aplicaciones están desconectadas de la base de datos. Las tecnologías son especialmente útiles para las aplicaciones que permiten a los usuarios modificar datos y conservar los cambios de nuevo en la base de datos. Aunque los conjuntos de datos son una tecnología probada de éxito, el enfoque recomendado para las nuevas aplicaciones .NET es usar Entity Framework Core. Entity Framework proporciona una manera más natural de trabajar con datos tabulares como modelos de objetos y tiene una interfaz de programación más sencilla.

Puede ampliar la funcionalidad de un TableAdapter agregando código al archivo de clase parcial de TableAdapter.

El código que define un TableAdapter se vuelve a generar cuando se realizan cambios en TableAdapter en el Diseñador de conjuntos de datos o cuando un asistente modifica la configuración de un TableAdapter. Para evitar que el código se elimine durante la regeneración de tableAdapter, agregue código al archivo de clase parcial de TableAdapter.

Las clases parciales permiten dividir el código de una clase específica entre varios archivos físicos. Para obtener más información, consulte Partial o partial (tipo).

Buscar TableAdapters en el código

Aunque TableAdapters están diseñados con el Diseñador de conjuntos de datos, las clases TableAdapter que se generan no son clases anidadas de DataSet. TableAdapters se encuentran en un espacio de nombres basado en el nombre del conjunto de datos asociado de TableAdapter. Por ejemplo, si la aplicación contiene un conjunto de datos denominado HRDataSet, TableAdapters se ubicaría en el HRDataSetTableAdapters espacio de nombres . (La convención de nomenclatura sigue este patrón: DatasetName + TableAdapters).

En el ejemplo siguiente se supone que un TableAdapter denominado CustomersTableAdapter está en un proyecto con NorthwindDataSet.

Para crear una clase parcial para tableAdapter

1. Agregue una nueva clase al proyecto; para ello, vaya al menú Proyecto y seleccione Agregar clase.

2. Asigne un nombre a la clase CustomersTableAdapterExtended.

3. Selecciona Agregar.

4. Reemplace el código por el espacio de nombres correcto y el nombre de clase parcial del proyecto de la siguiente manera:

   C#

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

   VB

   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
   

Contenido relacionado

• Rellenar conjuntos de datos mediante TableAdapters