Bagikan melalui

Panduan: Menangani Kesalahan yang Terjadi Selama Entri Data di Kontrol DataGridView Formulir Windows

Menangani kesalahan dari penyimpanan data yang mendasar adalah fitur yang diperlukan untuk aplikasi entri data. Kontrol DataGridView Windows Forms memudahkan ini dengan mengekspos peristiwa DataError, yang dimunculkan ketika penyimpanan data mendeteksi pelanggaran batasan atau aturan bisnis yang rusak.

Dalam panduan ini, Anda akan mengambil baris dari tabel Customers di database sampel Northwind dan menampilkannya dalam kontrol DataGridView. Ketika nilai duplikat CustomerID terdeteksi di baris baru atau baris yang sudah diedit, peristiwa DataError akan terjadi, yang akan ditangani dengan menampilkan MessageBox yang menjelaskan pengecualian.

Untuk menyalin kode dalam topik ini sebagai daftar tunggal, lihat Cara: Menangani Kesalahan yang Terjadi Selama Entri Data di Windows Forms DataGridView Control.

Prasyarat

Untuk menyelesaikan panduan ini, Anda akan memerlukan:

  • Akses ke server yang memiliki database sampel Northwind SQL Server.

Membuat Formulir

Untuk menangani kesalahan entri data di kontrol DataGridView

  1. Buat kelas yang berasal dari Form dan berisi kontrol DataGridView dan komponen BindingSource.

    Contoh kode berikut menyediakan inisialisasi dasar dan menyertakan metode 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. Terapkan metode dalam definisi kelas formulir Anda untuk menangani detail menyambungkan ke database.

    Contoh kode ini menggunakan metode GetData yang mengembalikan objek DataTable yang diisi. Pastikan Anda mengatur variabel connectionString ke nilai yang sesuai untuk database Anda.

    Penting

    Menyimpan informasi sensitif, seperti kata sandi, dalam string koneksi dapat memengaruhi keamanan aplikasi Anda. Menggunakan Autentikasi Windows (juga dikenal sebagai keamanan terintegrasi) adalah cara yang lebih aman untuk mengontrol akses ke database. Untuk informasi selengkapnya, lihat Melindungi Informasi Koneksi.

    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. Terapkan handler untuk peristiwa Load formulir Anda yang menginisialisasi DataGridView dan BindingSource dan menyiapkan pengikatan data.

    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. Tangani peristiwa DataError pada DataGridView.

    Jika konteks untuk kesalahan adalah operasi commit, tampilkan kesalahan dalam 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

Menguji Aplikasi

Anda sekarang dapat menguji formulir untuk memastikan formulir tersebut berulah seperti yang diharapkan.

Untuk menguji formulir

  • Tekan F5 untuk menjalankan aplikasi.

    Anda akan melihat kontrol DataGridView yang diisi dengan data dari tabel Pelanggan. Jika Anda memasukkan nilai duplikat untuk CustomerID dan melakukan pengeditan, nilai sel akan kembali secara otomatis dan Anda akan melihat MessageBox yang menampilkan kesalahan entri data.

Langkah Selanjutnya

Aplikasi ini memberi Anda pemahaman dasar tentang kemampuan kontrol DataGridView. Anda dapat menyesuaikan tampilan dan perilaku kontrol DataGridView dengan beberapa cara:

Lihat juga