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

  • Статья

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

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

В процессе выполнения этого пошагового руководства вы научитесь:

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

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

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

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

Чтобы создать новый проект Windows

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

  2. Назовите проект TableAdapterDbDirectMethodsWalkthrough.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Чтобы добавить кнопки, которые будут вызывать отдельные методы DbDirect объекта TableAdapter

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

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

    Имя

    Text

    InsertButton

    Вставить

    UpdateButton

    Обновить

    DeleteButton

    Удалить

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

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

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

    Private Sub InsertButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
    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);
}

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

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

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

    Private Sub UpdateButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
    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();
}

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

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

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

    Private Sub DeleteButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
    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 для запуска приложения.

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

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

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

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

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

См. также

Задачи

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

Практическое руководство. Создание запросов TableAdapter

Практическое руководство. Сохранение данных из объекта в базе данных

Основные понятия

Общие сведения об адаптере таблиц

Общие сведения об отображении данных

Другие ресурсы

Подключение к данным в Visual Studio

Подготовка приложения к получению данных

Выборка данных в приложение

Отображение данных на форме в приложениях Windows

Редактирование данных в приложении

Проверка данных

Сохранение данных