Поделиться через

Пошаговое руководство. Обработка ошибок, возникающих во время записи данных в элементе управления DataGridView в Windows Forms

Обработка ошибок из базового хранилища данных является обязательной функцией для приложения ввода данных. Элемент управления DataGridView Windows Forms упрощает задачу, предоставляя событие DataError, которое возникает при обнаружении нарушения ограничения или нарушения бизнес-правила.

В этом пошаговом руководстве вы получите строки из таблицы Customers в примере базы данных Northwind и отобразите их в элементе управления DataGridView. При обнаружении повторяющегося значения CustomerID в новой строке или измененной существующей строке произойдет событие DataError, которое будет обрабатываться путем отображения MessageBox, описывающего исключение.

Чтобы скопировать код в этом разделе в виде одного списка, см. раздел Практическое руководство. Обработка ошибок, возникающих во время записи данных в элементе управления DataGridView Windows Forms.

Предпосылки

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

  • Доступ к серверу с примером базы данных SQL Server Northwind.

Создание формы

Обработка ошибок ввода данных в элементе управления DataGridView

  1. Создайте класс, производный от Form и содержащий элемент управления DataGridView и компонент BindingSource.

    В следующем примере кода реализована базовая инициализация и включается метод Main.

    using System;
using System.Data;
using System.Data.SqlClient;
using System.Windows.Forms;

public class Form1 : System.Windows.Forms.Form
{
    private DataGridView dataGridView1 = new DataGridView();
    private BindingSource bindingSource1 = new BindingSource();

    public Form1()
    {
        // Initialize the form.
        this.dataGridView1.Dock = DockStyle.Fill;
        this.Controls.Add(dataGridView1);
        this.Load += new EventHandler(Form1_Load);
    }

    Imports System.Data
Imports System.Data.SqlClient
Imports System.Windows.Forms

Public Class Form1
    Inherits System.Windows.Forms.Form

    Private WithEvents dataGridView1 As New DataGridView()
    Private bindingSource1 As New BindingSource()

    Public Sub New()

        ' Initialize the form.
        Me.dataGridView1.Dock = DockStyle.Fill
        Me.Controls.Add(dataGridView1)

    End Sub

        [STAThread]
    static void Main()
    {
        Application.EnableVisualStyles();
        Application.Run(new Form1());
    }
}

        <STAThread()> _
    Shared Sub Main()
        Application.EnableVisualStyles()
        Application.Run(New Form1())
    End Sub

End Class

  2. Реализуйте метод в определении класса формы для обработки сведений о подключении к базе данных.

    В этом примере кода используется метод GetData, который возвращает заполненный объект DataTable. Убедитесь, что переменная connectionString имеет значение, соответствующее вашей базе данных.

    Это важно

    Хранение конфиденциальных данных, таких как пароль, в строке подключения может повлиять на безопасность приложения. Использование проверки подлинности Windows (также известной как встроенная безопасность) — это более безопасный способ управления доступом к базе данных. Дополнительные сведения см. в разделе Защита данных о подключении.

    private static DataTable GetData(string selectCommand)
{
    string connectionString =
        "Integrated Security=SSPI;Persist Security Info=False;" +
        "Initial Catalog=Northwind;Data Source=localhost;Packet Size=4096";

    // Connect to the database and fill a data table, including the
    // schema information that contains the CustomerID column
    // constraint.
    SqlDataAdapter adapter =
        new SqlDataAdapter(selectCommand, connectionString);
    DataTable data = new DataTable();
    data.Locale = System.Globalization.CultureInfo.InvariantCulture;
    adapter.Fill(data);
    adapter.FillSchema(data, SchemaType.Source);

    return data;
}

    Private Shared Function GetData(ByVal selectCommand As String) As DataTable

    Dim connectionString As String = _
        "Integrated Security=SSPI;Persist Security Info=False;" + _
        "Initial Catalog=Northwind;Data Source=localhost;Packet Size=4096"

    ' Connect to the database and fill a data table, including the 
    ' schema information that contains the CustomerID column 
    ' constraint.
    Dim adapter As New SqlDataAdapter(selectCommand, connectionString)
    Dim data As New DataTable()
    data.Locale = System.Globalization.CultureInfo.InvariantCulture
    adapter.Fill(data)
    adapter.FillSchema(data, SchemaType.Source)

    Return data

End Function

  3. Реализуйте обработчик для события Load формы, который инициализирует DataGridView и BindingSource и настраивает привязку данных.

    private void Form1_Load(System.Object sender, System.EventArgs e)
{
    // Attach the DataError event to the corresponding event handler.
    this.dataGridView1.DataError +=
        new DataGridViewDataErrorEventHandler(dataGridView1_DataError);

    // Initialize the BindingSource and bind the DataGridView to it.
    bindingSource1.DataSource = GetData("select * from Customers");
    this.dataGridView1.DataSource = bindingSource1;
    this.dataGridView1.AutoResizeColumns(
        DataGridViewAutoSizeColumnsMode.AllCellsExceptHeader);
}

    Private Sub Form1_Load(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Me.Load

    ' Initialize the BindingSource and bind the DataGridView to it.
    bindingSource1.DataSource = GetData("select * from Customers")
    Me.dataGridView1.DataSource = bindingSource1
    Me.dataGridView1.AutoResizeColumns( _
        DataGridViewAutoSizeColumnsMode.AllCellsExceptHeader)

End Sub

  4. Обработайте событие DataError в DataGridView.

    Если ошибка возникает в контексте операции фиксации, отобразите её в MessageBox.

    private void dataGridView1_DataError(object sender,
    DataGridViewDataErrorEventArgs e)
{
    // If the data source raises an exception when a cell value is
    // commited, display an error message.
    if (e.Exception != null &&
        e.Context == DataGridViewDataErrorContexts.Commit)
    {
        MessageBox.Show("CustomerID value must be unique.");
    }
}

    Private Sub dataGridView1_DataError(ByVal sender As Object, _
    ByVal e As DataGridViewDataErrorEventArgs) _
    Handles dataGridView1.DataError

    ' If the data source raises an exception when a cell value is 
    ' commited, display an error message.
    If e.Exception IsNot Nothing AndAlso _
        e.Context = DataGridViewDataErrorContexts.Commit Then

        MessageBox.Show("CustomerID value must be unique.")

    End If

End Sub

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

Теперь вы можете протестировать форму, чтобы убедиться, что она работает должным образом.

Тестирование формы

  • Нажмите клавишу F5, чтобы запустить приложение.

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

Дальнейшие шаги

Это приложение дает базовое представление о возможностях элемента управления DataGridView. Внешний вид и поведение элемента управления DataGridView можно настроить несколькими способами:

См. также