Пошаговое руководство. Сохранение данных с помощью методов DBDirect адаптера таблицы
Это пошаговое руководство содержит подробные указания по выполнению инструкций SQL непосредственно для базы данных с помощью методов DBDirect адаптера таблицы. Методы DBDirect адаптера таблицы обеспечивают точный контроль над обновлениями базы данных. С их помощью вы можете выполнять определенные инструкции SQL и хранимые процедуры, вызывая отдельные методы Insert, Update и Delete в соответствии с потребностями приложения (в противоположность перегруженному методу Update, который выполняет инструкции UPDATE, INSERT и DELETE в одном вызове).
В этом пошаговом руководстве описаны следующие процедуры.
Создание нового проекта Приложение Windows.
Создание и настройка набора данных с помощью мастер настройки источника данных.
Выбор элемента управления, создаваемого на форме при перетаскивании элементов из окна Источники данных. Для получения дополнительной информации см. Практическое руководство. Установка элемента управления, создаваемого при перетаскивании из окна "Источники данных".
Создание формы с привязкой к данным посредством перетаскивания элементов из окна Источники данных на форму.
Добавление методов для прямого доступа к базе данных и выполнения вставок, обновлений и удалений непосредственно в базе данных.
Обязательные компоненты
Для выполнения данного пошагового руководства требуется:
- Доступ к примеру базы данных "Борей". Для получения дополнительной информации см. Практическое руководство. Установка образцов баз данных.
Создание приложения Windows
Первым шагом является создание Приложения Windows.
Порядок создания нового проекта Windows
В меню Файл Visual Studio создайте новый Проект.
Присвойте проекту имя TableAdapterDbDirectMethodsWalkthrough.
Выберите Приложение Windows и нажмите кнопку ОК. Для получения дополнительной информации см. Разработка клиентских приложений с использованием .NET Framework.
Создается проект TableAdapterDbDirectMethodsWalkthrough, который добавляется в Обозреватель решений.
Создание источника данных из вашей базы данных
В этом шаге Мастер настройки источника данных используется для создания источника данных на основе таблицы Region в учебной базе данных "Борей". Для создания подключения необходимо иметь доступ к учебной базе данных "Борей". Дополнительные сведения о настройке учебной базы данных "Борей" см. в разделе Практическое руководство. Установка образцов баз данных.
Создание источника данных
В меню Данные выберите команду Показать источники данных.
В окне Источники данных выберите Добавить новый источник данных, чтобы запустить Мастер настройки источника данных.
На странице Выбор типа источника данных выберите элемент База данных и нажмите Далее.
На странице Выбор подключения к базе данных выполните одно из следующих действий.
Если подключение к учебной базе данных Northwind доступно в раскрывающемся списке, то выберите его.
-или-
Выберите Новое подключение для открытия диалогового окна Добавить/изменить подключение.
Если базе данных требуется пароль, выберите параметр для включения конфиденциальных данных и щелкните Далее.
На странице Сохранение подключения в файле конфигурации приложения нажмите кнопку Далее.
Разверните узел Таблицы на странице Выбор объектов базы данных.
Выберите таблицу Region и нажмите Готово.
Объект NorthwindDataSet добавляется в проект, и таблица Region отображается в окне Источники данных.
Добавление элементов управления в форму для отображения данных
Создайте элементы управления с привязкой к данным с помощью перетаскивания элементов из окна Источники данных на форму.
Создание элементов управления с привязкой к данным на форме Windows Forms
Перетащите главный узел Регион из окна Источники данных на форму.
На форме появляется элемент DataGridView и панель инструментов (BindingNavigator) для перемещения по записям. В области компонентов появляется NorthwindDataSet, RegionTableAdapter, BindingSource и BindingNavigator.
Порядок добавления кнопок, вызывающих отдельные методы DbDirect адаптера таблицы
Перетащите три элемента управления Button из Области элементов на Form1 (под RegionDataGridView).
Задайте следующие свойства Имя и Текст для каждой из кнопок.
Имя
Text
InsertButton
Insert
UpdateButton
Обновление
DeleteButton
Удаление
Добавление кода для вставки новых записей в базу данных
Дважды щелкните InsertButton, чтобы создать обработчик событий для события щелчка кнопкой мыши и открыть форму в редакторе кода.
Замените обработчик событий InsertButton_Click следующим кодом:
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
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); }
Добавление кода для обновления записей в базе данных
Дважды щелкните UpdateButton, чтобы создать обработчик событий для события щелчка кнопкой мыши и открыть форму в редакторе кода.
Замените обработчик событий UpdateButton_Click следующим кодом:
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
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(); }
Добавление кода для удаления записей в базе данных
Дважды щелкните DeleteButton, чтобы создать обработчик событий для события щелчка кнопкой мыши и открыть форму в редакторе кода.
Замените обработчик событий DeleteButton_Click следующим кодом:
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
private void DeleteButton_Click(object sender, EventArgs e) { try { regionTableAdapter1.Delete(5, "Updated Region Description"); } catch (Exception ex) { MessageBox.Show("Delete Failed"); } RefreshDataset(); }
Запуск приложения
Запуск приложения
Нажмите клавишу F5 для запуска приложения.
Нажмите кнопку Вставка и убедитесь, что в сетке отображается новая запись.
Нажмите кнопку Обновление и убедитесь, что запись в сетке обновляется.
Нажмите кнопку Удаление и убедитесь, что запись удаляется из сетки.
Следующие действия
В зависимости от требований приложения существуют несколько шагов, которые, возможно, потребуется выполнить после создания формы с привязкой к данным. Ниже приводится перечень рекомендаций, позволяющих улучшить полученный результат.
Добавление функциональности поиска в форму. Для получения дополнительной информации см. Практическое руководство. Добавление параметризованного запроса в приложение Windows Forms.
Добавление дополнительных таблиц в набор данных посредством выбора элемента Настроить набор данных с помощью мастера в окне Источники данных. Вы можете добавить элементы управления, отображающие связанные данные, перетащив связанные узлы на форму. Для получения дополнительной информации см. Практическое руководство. Отображение связанных данные в приложении Windows Forms.
См. также
Задачи
Практическое руководство. Непосредственный доступ к базе данных с помощью адаптера таблицы
Практическое руководство. Создание запросов TableAdapter
Практическое руководство. Сохранение данных из объекта в базе данных
Основные понятия
Общие сведения об адаптере таблиц
Привязка элементов управления Windows Forms к данным в Visual Studio
Подготовка приложения к получению данных
Привязка элементов управления к данным в Visual Studio
Редактирование данных в приложении