Пошаговое руководство. Сохранение данных в базе данных (одна таблица)

Статья
06/10/2015

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

Вы можете сохранить данные из приложения в базе данных, вызвав метод Update адаптера таблицы. При перетаскивании элементов из окна Источники данных код для сохранения данных автоматически добавляется для первой таблицы, помещенной на форму. Для добавляемых на форму дополнительных таблиц код для сохранения данных требуется добавлять вручную. Сведения о сохранении данных из нескольких таблиц см. в разделе Пошаговое руководство. Сохранение данных в базе данных (несколько таблиц).

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

Создание нового проекта Приложение Windows.
Создание и настройка источника данных в приложении с помощью мастер настройки источника данных.
Настройка элементов управления для элементов в окно "Источники данных". Для получения дополнительной информации см. Практическое руководство. Установка элемента управления, создаваемого при перетаскивании из окна "Источники данных".
Создание элементов управления с привязкой к данным с помощью перетаскивания элементов из окна Источники данных на форму.
Изменение пары записей в наборе данных.
Добавление кода для отправки обновленных данных в наборе данных обратно в базу данных.

Примечание

Отображаемые диалоговые окна и команды меню могут отличаться от описанных в справке в зависимости от текущих параметров или выпуска.Чтобы изменить параметры, выберите в меню Сервис пункт Импорт и экспорт параметров.Для получения дополнительной информации см. Настройка параметров разработки в Visual Studio.

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

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

Доступ к примеру базы данных "Борей". Для получения дополнительной информации см. Практическое руководство. Установка образцов баз данных.

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

Первым шагом является создание Приложения Windows. На данном этапе имя проекту можно не назначать, однако мы зададим его, так как позднее планируем сохранить проект.

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

Перейдите в меню Файл и создайте новый проект.
Присвойте проекту имя UpdateSingleTableWalkthrough.
Выберите Приложение Windows и нажмите кнопку ОК. Для получения дополнительной информации см. Разработка клиентских приложений с использованием .NET Framework.

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

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

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

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

В меню Данные выберите команду Показать источники данных.
В окне Источники данных выберите Добавить новый источник данных, чтобы запустить Мастер настройки источника данных.
На странице Выбор типа источника данных выберите элемент База данных и нажмите Далее.
На странице Выбор подключения к базе данных выполните одно из следующих действий.
- Если подключение к учебной базе данных Northwind доступно в раскрывающемся списке, то выберите его.
  
  -или-
- Выберите Новое подключение для открытия диалогового окна Добавить/изменить подключение.
Если базе данных требуется пароль, выберите параметр для включения конфиденциальных данных и щелкните Далее.
На странице Сохранение подключения в файле конфигурации приложения нажмите кнопку Далее.
Разверните узел Таблицы на странице Выбор объектов базы данных.
Выберите таблицу Клиенты и нажмите Готово.

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

Настройка создаваемых элементов управления

В рамках этого пошагового руководства данные будут находиться в макете Сведения, где данные отображаются в отдельных элементах управления, а не в макете по умолчанию DataGridView.

Установка элементов управления для элементов в окне "Источники данных"

Разверните узел Клиенты в окне Источники данных.
Измените элемент управления таблицы Клиенты на отдельные элементы управления, выбрав Сведения в раскрывающемся списке в узле Клиенты. Для получения дополнительной информации см. Практическое руководство. Установка элемента управления, создаваемого при перетаскивании из окна "Источники данных".

Создание формы с привязкой к данным

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

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

Перетащите главный узел Клиенты из окна Источники данных на Form1.

Привязанные к данным элементы управления с метками описания отображаются на форме вместе с панелью инструментов (BindingNavigator) для перемещения по записям. В области компонентов появляется NorthwindDataSet, CustomersTableAdapter, BindingSource и BindingNavigator.

Изменение кода для обновления базы данных

Вы можете обновить базу данных, вызвав метод Update адаптера таблицы CustomersTableAdapter. По умолчанию обработчик событий для кнопки Сохранить BindingNavigator добавляется в код формы для отправки обновлений в базу данных. Эта процедура изменяет код, чтобы он реализовал обработку ошибок, упаковывая вызов обновления в блок try-catch. Вы можете изменить этот код в соответствии с потребностями своего приложения.

Добавление логики обновления в приложение

Дважды нажмите кнопку Сохранить на BindingNavigator, чтобы открыть Редактор кода с обработчиком событий bindingNavigatorSaveItem_Click.

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

Try 
    Me.Validate()
    Me.CustomersBindingSource.EndEdit()
    Me.CustomersTableAdapter.Update(Me.NorthwindDataSet.Customers)
    MsgBox("Update successful")

Catch ex As Exception
    MsgBox("Update failed")
End Try

try
{
    this.Validate();
    this.customersBindingSource.EndEdit();
    this.customersTableAdapter.Update(this.northwindDataSet.Customers);
    MessageBox.Show("Update successful");
}
catch (System.Exception ex)
{
    MessageBox.Show("Update failed");
}

Тестирование приложения

Нажмите клавишу F5.
Внесите изменения в данные одной или нескольких записей.
Нажмите кнопку Сохранить.
Проверьте значения в базе данных и убедитесь, что изменения были сохранены.

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

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