Расширение функциональных возможностей TableAdapter в приложениях .NET Framework

Замечание

Классы DataSet и связанные классы являются устаревшими технологиями .NET Framework с начала 2000-х годов, которые позволяют приложениям работать с данными в памяти, пока приложения отключены от базы данных. Технологии особенно полезны для приложений, которые позволяют пользователям изменять данные и сохранять изменения обратно в базу данных. Хотя наборы данных являются проверенными успешными технологиями, рекомендуемый подход для новых приложений .NET заключается в использовании Entity Framework Core. Entity Framework предоставляет более естественный способ работы с табличными данными в виде объектных моделей и имеет более простой интерфейс программирования.

Вы можете расширить функциональные возможности TableAdapter, добавив код в файл частичного класса TableAdapter.

Код, определяющий TableAdapter, пересоздается при внесении любых изменений в TableAdapter в Конструкторе наборов данных или при изменении конфигурации с помощью мастера настроек. Чтобы предотвратить удаление кода во время повторного создания TableAdapter, добавьте код в файл частичного класса TableAdapter.

Частичные классы позволяют разделить код для определенного класса между несколькими физическими файлами. Дополнительные сведения см. в разделе Partial или partial (тип)).

Поиск TableAdapters в коде

Хотя TableAdapters разработаны с помощью конструктора наборов данных, созданные классы TableAdapter не являются вложенными классами DataSet. TableAdapters располагаются в пространстве имен, которое построено на основе имени набора данных, связанного с TableAdapter. Например, если приложение содержит набор данных с именем HRDataSet, то TableAdapters будут находиться в пространстве имен HRDataSetTableAdapters. (Правило именования следует этому шаблону: DatasetName + TableAdapters).

В следующем примере предполагается, что TableAdapter с именем CustomersTableAdapter используется в проекте с NorthwindDataSet.

Создание частичного класса для TableAdapter

  1. Добавьте новый класс в проект, перейдя в меню "Проект " и выбрав "Добавить класс".

  2. Присвойте классу CustomersTableAdapterExtendedимя.

  3. Нажмите кнопку "Добавить".

  4. Замените код на правильное пространство имен и частичное имя класса для вашего проекта следующим образом:

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