Cómo: Extender la funcionalidad de un TableAdapter

Actualización: noviembre 2007

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 (Visual Basic) o Tipo parcial (Referencia de C#).)

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 haciendo clic en 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
    
        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
    
    namespace NorthwindDataSetTableAdapters
    {
        public partial class CustomersTableAdapter
        {
            // Add user code here. For example:
            public override string ToString()
            {
                return "Overridden in the partial class.";
            }
        }
    }
    

Vea también

Tareas

Cómo: Crear TableAdapters

Cómo: Crear consultas de TableAdapter

Cómo: Extender la funcionalidad de un conjunto de datos

Conceptos

Información general sobre TableAdapter

Información general sobre la presentación de datos

Otros recursos

Tutoriales sobre datos

Introducción a Data Access

Conectarse a datos en Visual Studio

Preparar la aplicación para recibir datos

Buscar datos en la aplicación

Mostrar datos en formularios en aplicaciones para Windows

Modificar datos en la aplicación

Validar datos

Guardar datos