Пошаговое руководство. Сохранение данных с помощью методов DBDirect адаптера таблицы

  • Статья

 

Опубликовано: Апрель 2016

Это пошаговое руководство содержит подробные указания по выполнению инструкций SQL непосредственно для базы данных с помощью методов DBDirect адаптера таблицы. Методы DBDirect адаптера таблицы обеспечивают точный контроль над обновлениями базы данных. С их помощью вы можете выполнять определенные инструкции SQL и хранимые процедуры, вызывая отдельные методы Insert, Update и Delete в соответствии с потребностями приложения (в противоположность перегруженному методу Update, который выполняет инструкции UPDATE, INSERT и DELETE в одном вызове).

В этом пошаговом руководстве описаны следующие процедуры.

Обязательные компоненты

Для выполнения данного пошагового руководства требуется:

Создание приложения Windows

Первым шагом является создание Приложения Windows.

Порядок создания нового проекта Windows

  1. В меню Файл Visual Studio создайте новый Проект.

  2. Присвойте проекту имя TableAdapterDbDirectMethodsWalkthrough.

  3. Выберите Приложение Windows и нажмите кнопку ОК. Для получения дополнительной информации см. Клиентские приложения.

    Создается проект TableAdapterDbDirectMethodsWalkthrough, который добавляется в Обозреватель решений.

Создание источника данных из вашей базы данных

В этом шаге Мастер настройки источника данных используется для создания источника данных на основе таблицы Region в учебной базе данных "Борей". Для создания подключения необходимо иметь доступ к учебной базе данных "Борей". Дополнительные сведения о настройке учебной базы данных "Борей" см. в разделе Практическое руководство. Установка образцов баз данных.

Создание источника данных

  1. В меню Данные выберите команду Показать источники данных.

  2. В окне Источники данных выберите Добавить новый источник данных, чтобы запустить Мастер настройки источника данных.

  3. На странице Выбор типа источника данных выберите элемент База данных и нажмите Далее.

  4. На странице Выбор подключения к базе данных выполните одно из следующих действий.

    • Если подключение к учебной базе данных Northwind доступно в раскрывающемся списке, то выберите его.

      -или-

    • Выберите Новое подключение для открытия диалогового окна Добавить/изменить подключение.

  5. Если базе данных требуется пароль, выберите параметр для включения конфиденциальных данных и щелкните Далее.

  6. На странице Сохранение подключения в файле конфигурации приложения нажмите кнопку Далее.

  7. Разверните узел Таблицы на странице Выбор объектов базы данных.

  8. Выберите таблицу Region и нажмите Готово.

    Объект NorthwindDataSet добавляется в проект, и таблица Region отображается в окне Источники данных.

Добавление элементов управления в форму для отображения данных

Создайте элементы управления с привязкой к данным с помощью перетаскивания элементов из окна Источники данных на форму.

Создание элементов управления с привязкой к данным на форме Windows Forms

Порядок добавления кнопок, вызывающих отдельные методы DbDirect адаптера таблицы

  1. Перетащите три элемента управления Button из Области элементов на Form1 (под RegionDataGridView).

  2. Задайте следующие свойства Имя и Текст для каждой из кнопок.

    Имя Text
    InsertButton Insert
    UpdateButton Обновление
    DeleteButton Удаление

Добавление кода для вставки новых записей в базу данных

  1. Дважды щелкните InsertButton, чтобы создать обработчик событий для события щелчка кнопкой мыши и открыть форму в редакторе кода.

  2. Замените обработчик событий InsertButton_Click следующим кодом:

            private void InsertButton_Click(object sender, EventArgs e)
        {
            Int32 newRegionID = 5;
            String newRegionDescription = "NorthEastern";

            try
            {
                regionTableAdapter1.Insert(newRegionID, newRegionDescription);
            }
            catch (Exception ex)
            {
                MessageBox.Show("Insert Failed");
            }
            RefreshDataset();
        }


        private void RefreshDataset()
        {
            this.regionTableAdapter1.Fill(this.northwindDataSet1.Region);
        }

        Private Sub InsertButton_Click() Handles InsertButton.Click

        Dim newRegionID As Integer = 5
        Dim newRegionDescription As String = "NorthEastern"

        Try
            RegionTableAdapter1.Insert(newRegionID, newRegionDescription)

        Catch ex As Exception
            MessageBox.Show("Insert Failed")
        End Try

        RefreshDataset()
    End Sub


    Private Sub RefreshDataset()
        Me.RegionTableAdapter1.Fill(Me.NorthwindDataSet1._Region)
    End Sub

Добавление кода для обновления записей в базе данных

  1. Дважды щелкните UpdateButton, чтобы создать обработчик событий для события щелчка кнопкой мыши и открыть форму в редакторе кода.

  2. Замените обработчик событий UpdateButton_Click следующим кодом:

            private void UpdateButton_Click(object sender, EventArgs e)
        {
            Int32 newRegionID = 5;

            try
            {
                regionTableAdapter1.Update(newRegionID, "Updated Region Description", 5, "NorthEastern");
            }
            catch (Exception ex)
            {
                MessageBox.Show("Update Failed");
            }
            RefreshDataset();
        }

        Private Sub UpdateButton_Click() Handles UpdateButton.Click

        Dim newRegionID As Integer = 5

        Try
            RegionTableAdapter1.Update(newRegionID, "Updated Region Description", 5, "NorthEastern")

        Catch ex As Exception
            MessageBox.Show("Update Failed")
        End Try

        RefreshDataset()
    End Sub

Добавление кода для удаления записей в базе данных

  1. Дважды щелкните DeleteButton, чтобы создать обработчик событий для события щелчка кнопкой мыши и открыть форму в редакторе кода.

  2. Замените обработчик событий DeleteButton_Click следующим кодом:

            private void DeleteButton_Click(object sender, EventArgs e)
        {
            try
            {
                regionTableAdapter1.Delete(5, "Updated Region Description");
            }
            catch (Exception ex)
            {
                MessageBox.Show("Delete Failed");
            }
            RefreshDataset();
        }

        Private Sub DeleteButton_Click() Handles DeleteButton.Click

        Try
            RegionTableAdapter1.Delete(5, "Updated Region Description")

        Catch ex As Exception
            MessageBox.Show("Delete Failed")
        End Try

        RefreshDataset()
    End Sub

Запуск приложения

Запуск приложения

  • Нажмите клавишу F5 для запуска приложения.

  • Нажмите кнопку Вставка и убедитесь, что в сетке отображается новая запись.

  • Нажмите кнопку Обновление и убедитесь, что запись в сетке обновляется.

  • Нажмите кнопку Удаление и убедитесь, что запись удаляется из сетки.

Следующие действия

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

См. также

Общие сведения об адаптере таблиц
Практическое руководство. Непосредственный доступ к базе данных с помощью адаптера таблицы
Практическое руководство. Создание запросов TableAdapter
Практическое руководство. Сохранение данных из объекта в базе данных
Привязка элементов управления Windows Forms к данным в Visual Studio
Подключение к данным в Visual Studio
Подготовка приложения к получению данных
Выборка данных в приложение
Привязка элементов управления к данным в Visual Studio
Редактирование данных в приложении
Проверка данных
Сохранение данных