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

Статья
11/05/2008

Обновлен: Ноябрь 2007

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

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

В этом пошаговом руководстве рассматриваются следующие задачи:

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

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

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

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

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

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

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

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

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

Из меню Файл создайте новый проект.
Назовите проект UpdateSingleTableWalkthrough.
Выберите Приложение Windows и нажмите кнопку OK. Дополнительные сведения см. в разделе Создание приложения для Windows.

Проект UpdateSingleTableWalkthrough будет создан и добавлен в Обозреватель решений.

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

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

Для создания источника данных

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

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

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

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

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

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

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

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

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

Перетащите главный узел Customers из окна Источники данных на 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. Ниже приводится перечень рекомендаций, позволяющих улучшить полученный результат.