Cómo: Agregar código a conjuntos de datos en aplicaciones con n niveles

Actualización: noviembre 2007

Puede extender la funcionalidad de un conjunto de datos creando un archivo de clase parcial para el conjunto de datos y agregándole código (en lugar de agregar código al archivo DatasetNameDataSet.Designer). (Las clases parciales habilitan al código para que una clase concreta se divida entre varios archivos físicos. Para obtener más información, vea Partial (Visual Basic) o Clases y métodos parciales (Guía de programación de C#).)

Se genera el código que define un conjunto de datos vez que se realizan cambios en la definición del conjunto de datos (en el Diseñador de DataSet). Este código también se genera cuando se realizan cambios durante el funcionamiento de cualquier asistente que modifica la configuración de un conjunto de datos. Para evitar que el código se elimine durante la regeneración de un conjunto de datos, agregue el código al archivo de clase parcial del conjunto de datos.

De forma predeterminada, después de separar el conjunto de datos y el código de TableAdapter, el resultado es un archivo de clase independiente en cada proyecto. El proyecto original tiene un archivo que se denomina DatasetName.Designer.vb (o DatasetName.Designer.cs) que contiene el código de TableAdapter. El proyecto designado en la propiedad DataSet Project tiene un archivo que se denomina DatasetName.DataSet.Designer.vb (o DatasetName.DataSet.Designer.cs) que contiene el código del conjunto de datos.

Nota:

Cuando se separan conjuntos de datos y TableAdapters (estableciendo la propiedad DataSet Project), las clases de conjunto de datos parciales existentes en el proyecto no se trasladarán automáticamente. Las clases de conjunto de datos parciales existentes se deberán trasladar manualmente al proyecto de conjunto de datos.

Nota:

El Diseñador de DataSet también proporciona la funcionalidad para generar ColumnChanging y los controladores de eventos RowChanging cuando se debería agregar el código de validación. Para obtener más información, vea Cómo: Agregar validación a un conjunto de datos con n niveles.

Para agregar código a conjuntos de datos en aplicaciones con n niveles

  1. Busque el proyecto que contiene el archivo .xsd (el Diseñador de DataSet).

  2. Haga doble clic en el archivo .xsd para abrir el Diseñador de DataSet.

  3. Haga clic con el botón secundario en la tabla de datos a la que desea agregar el código (el nombre de tabla en la barra de título) y haga clic en Ver código.

    Se crea una clase parcial y se abre en el Editor de código.

  4. Agregue el código dentro de la declaración de clase parcial.

    En el ejemplo siguiente se muestra dónde agregar el código a CustomersDataTable en el NorthwindDataSet:

    Partial Public Class CustomersDataTable
        ' Add code here to add functionality 
        ' to the CustomersDataTable.
    End Class
    
    partial class CustomersDataTable
    {
        // Add code here to add functionality
        // to the CustomersDataTable.
    }
    

Vea también

Tareas

Cómo: Agregar código a TableAdapters en aplicaciones con n niveles

Conceptos

Información general sobre aplicaciones de datos con n niveles

Información general sobre TableAdapterManager

Información general sobre la actualización jerárquica

Información general sobre conjuntos de datos en Visual Studio

Otros recursos

TableAdapters

Crear aplicaciones de datos cliente