Agregue código a conjuntos de datos en aplicaciones de n nivelesAdd code to datasets in n-tier applications

Puede ampliar la funcionalidad de un conjunto de datos mediante la creación de un archivo de clase parcial para el conjunto de datos y agregar código a él (en lugar de agregar código a la DatasetName. Archivo Dataset.Designer).You can extend the functionality of a dataset by creating a partial class file for the dataset and adding code to it (instead of adding code to the DatasetName.Dataset.Designer file). Clases parciales permiten al código para una clase concreta se divida entre varios archivos físicos.Partial classes enable code for a specific class to be divided among multiple physical files. Para obtener más información, consulte parcial o clases y métodos parciales.For more information, see Partial or Partial Classes and Methods.

El código que define un conjunto de datos se genera cada vez que se realizan cambios en la definición de conjunto de datos (en el conjunto de datos con tipo).The code that defines a dataset is generated every time changes are made to the dataset definition (in the typed 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.This code is also generated when you make changes during the running of any wizard that modifies the configuration of a dataset. Para evitar que el código que se eliminen durante la regeneración de un conjunto de datos, agregue código al archivo de clase parcial del conjunto de datos.To prevent your code from being deleted during the regeneration of a dataset, add code to the dataset's partial class file.

De forma predeterminada, después de separar el conjunto de datos y el código de TableAdapter, el resultado es un archivo de clase adicional en cada proyecto.By default, after you separate the dataset and TableAdapter code, the result is a discrete class file in each project. El proyecto original tiene un archivo denominado DatasetName. Designer.vb (o DatasetName. Designer.cs) que contiene el código de TableAdapter.The original project has a file named DatasetName.Designer.vb (or DatasetName.Designer.cs) that contains the TableAdapter code. El proyecto designado en la Dataset Project propiedad tiene un archivo que se denomina DatasetName. DataSet.Designer.vb (o DatasetName. (DataSet.Designer.cs). Este archivo contiene el código de conjunto de datos.The project that's designated in the Dataset Project property has a file that's named DatasetName.DataSet.Designer.vb (or DatasetName.DataSet.Designer.cs).This file contains the dataset code.

Nota

Al separar conjuntos de datos y los TableAdapters (estableciendo la DataSet Project propiedad), las clases de conjunto de datos parciales existentes en el proyecto no se traslada automáticamente.When you separate datasets and TableAdapters (by setting the DataSet Project property), existing partial dataset classes in the project won't be moved automatically. Las clases de conjunto de datos parciales existentes se deberán trasladar manualmente al proyecto de conjunto de datos.Existing dataset partial classes must be moved manually to the dataset project.

Nota

Cuando es necesario agregar código de validación, el conjunto de datos con tipo proporciona la funcionalidad para generar ColumnChanging y RowChanging controladores de eventos.When validation code needs to be added, the typed dataset provides functionality for generating ColumnChanging and RowChanging event handlers. Para obtener más información, consulte agregar validación a un conjunto de datos con n niveles.For more information, see Add validation to an n-tier dataset.

Para agregar código a conjuntos de datos en aplicaciones de n nivelesTo add code to datasets in n-tier applications

  1. Localice el proyecto que contiene el archivo .xsd.Locate the project that contains the .xsd file.

  2. Seleccione el .xsd archivo para abrir el conjunto de datos.Select the .xsd file to open the dataset.

  3. Haga clic en la tabla de datos a la que desea agregar el código (el nombre de tabla en la barra de título) y, a continuación, seleccione ver código.Right-click the data table to which you want to add code (the table name in the title bar), and then select View Code.

    Una clase parcial se crea y se abre en el Editor de código.A partial class is created and opens in the Code Editor.

  4. Agregue el código dentro de la declaración de clase parcial.Add code inside the partial class declaration.

    En el ejemplo siguiente se muestra dónde agregar código a CustomersDataTable en el NorthwindDataSet:The following example shows where to add code to the CustomersDataTable in the 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énSee also

Información general sobre aplicaciones de datos con N niveles N-Tier Data Applications Overview
Agregar código a TableAdapters en aplicaciones con n nivelesAdd code to TableAdapters in n-tier applications
Crear y configurar los TableAdaptersCreate and Configure TableAdapters
Información general de la actualización jerárquica Hierarchical Update Overview
Herramientas de conjunto de datos en Visual StudioDataset tools in Visual Studio