Compartir a través de

Cómo: Extender la funcionalidad de un TableAdapter

  • Artículo

 

Publicado: abril de 2016

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

El código que define un objeto TableAdapter se vuelve a generar cuando se realizan cambios en el TableAdapter (en el Diseñador de Dataset) o cuando se realizan cambios en la ejecución de cualquier asistente que modifiquen la configuración de un TableAdapter. Para evitar que su código sea eliminado durante la regeneración de un objeto TableAdapter, agregue código al archivo de clase parcial del TableAdapter.

(Las clases parciales permiten que el código para una clase concreta se divida entre varios archivos físicos. Para obtener más información, vea Partial o partial (Tipos).)

Buscar TableAdapters en el código

Aunque los objetos TableAdapter se diseñan con el Diseñador de DataSet, las clases TableAdapter generadas no se generan como clases anidadas de DataSet. Los objetos TableAdapter se buscan en un espacio de nombres basado en el nombre del conjunto de datos asociado del TableAdapter. Por ejemplo, si su aplicación contiene un conjunto de datos denominado HRDataSet, los TableAdapters se buscarían en el espacio de nombres HRDataSetTableAdapters. (La convención de nomenclatura sigue este patrón: DatasetName + TableAdapters).

El ejemplo siguiente supone un TableAdapter denominado CustomersTableAdapter en un proyecto con NorthwindDataSet.

Para crear una clase parcial para un TableAdapter

  1. Agregue una clase nueva al proyecto eligiendo Agregar clase en el menú Proyecto.

  2. Asigne a la clase el nombre CustomersTableAdapterExtended.

  3. Haga clic en Agregar.

  4. Reemplace el código con el espacio de nombres y el nombre de clase parcial correspondientes a su proyecto. Por ejemplo:

    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

Vea también

Información general sobre TableAdapter
Cómo: Crear TableAdapters
Cómo: Crear consultas de TableAdapter
Cómo: Extender la funcionalidad de un conjunto de datos
Tutoriales sobre datos
Enlazar controles de Windows Forms a datos en Visual Studio
Información general de las aplicaciones de datos en Visual Studio
Conectarse a datos en Visual Studio
Preparar la aplicación para recibir datos
Buscar datos en la aplicación
Enlazar controles a los datos en Visual Studio
Modificar datos en la aplicación
Validar datos
Guardar datos