Bagikan melalui

Panduan: Memvalidasi Data di Kontrol Windows Forms DataGridView

Saat Anda menampilkan fungsionalitas entri data kepada pengguna, Anda sering harus memvalidasi data yang dimasukkan ke dalam formulir Anda. Kelas DataGridView menyediakan cara mudah untuk melakukan validasi sebelum data diterapkan ke penyimpanan data. Anda dapat memvalidasi data dengan menangani peristiwa CellValidating, yang dipicu oleh DataGridView ketika sel aktif berubah.

Dalam panduan ini, Anda akan mengambil baris dari tabel Customers di database sampel Northwind dan menampilkannya dalam kontrol DataGridView. Saat pengguna mengedit sel di kolom CompanyName dan mencoba meninggalkan sel, penanganan aktivitas CellValidating akan memeriksa string nama perusahaan baru untuk memastikannya tidak kosong; jika nilai baru adalah string kosong, DataGridView akan mencegah kursor pengguna meninggalkan sel hingga string yang tidak kosong dimasukkan.

Untuk menyalin kode dalam topik ini sebagai daftar tunggal, lihat Cara: Memvalidasi Data di Kontrol Windows Forms DataGridView.

Prasyarat

Untuk menyelesaikan panduan ini, Anda akan memerlukan:

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

Membuat Formulir

Untuk memvalidasi data yang dimasukkan dalam 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);
        this.Text = "DataGridView validation demo (disallows empty CompanyName)";
    }

    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)
        Me.Text = "DataGridView validation demo (disallows empty CompanyName)"

    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.
    SqlDataAdapter adapter =
        new SqlDataAdapter(selectCommand, connectionString);
    DataTable data = new DataTable();
    data.Locale = System.Globalization.CultureInfo.InvariantCulture;
    adapter.Fill(data);

    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.
    Dim adapter As New SqlDataAdapter(selectCommand, connectionString)
    Dim data As New DataTable()
    data.Locale = System.Globalization.CultureInfo.InvariantCulture
    adapter.Fill(data)

    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 DataGridView events to the corresponding event handlers.
    this.dataGridView1.CellValidating += new
        DataGridViewCellValidatingEventHandler(dataGridView1_CellValidating);
    this.dataGridView1.CellEndEdit += new
        DataGridViewCellEventHandler(dataGridView1_CellEndEdit);

    // 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. Terapkan handler untuk acara DataGridView dan CellValidating kontrol CellEndEdit.

    Penanganan aktivitas CellValidating adalah tempat Anda menentukan apakah nilai sel di kolom CompanyName kosong. Jika nilai sel gagal validasi, atur properti Cancel kelas System.Windows.Forms.DataGridViewCellValidatingEventArgs ke true. Ini menyebabkan kontrol DataGridView mencegah kursor meninggalkan sel. Atur properti ErrorText pada baris ke string penjelasan. Ini menampilkan ikon kesalahan dengan TipsAlat yang berisi teks kesalahan. Di penanganan acara CellEndEdit, atur properti ErrorText pada baris menjadi string kosong. Peristiwa CellEndEdit hanya terjadi ketika sel keluar dari mode edit, yang tidak dapat dilakukan jika gagal validasi.

    private void dataGridView1_CellValidating(object sender,
    DataGridViewCellValidatingEventArgs e)
{
    string headerText =
        dataGridView1.Columns[e.ColumnIndex].HeaderText;

    // Abort validation if cell is not in the CompanyName column.
    if (!headerText.Equals("CompanyName")) return;

    // Confirm that the cell is not empty.
    if (string.IsNullOrEmpty(e.FormattedValue.ToString()))
    {
        dataGridView1.Rows[e.RowIndex].ErrorText =
            "Company Name must not be empty";
        e.Cancel = true;
    }
}

void dataGridView1_CellEndEdit(object sender, DataGridViewCellEventArgs e)
{
    // Clear the row error in case the user presses ESC.
    dataGridView1.Rows[e.RowIndex].ErrorText = String.Empty;
}

    Private Sub dataGridView1_CellValidating(ByVal sender As Object, _
    ByVal e As DataGridViewCellValidatingEventArgs) _
    Handles dataGridView1.CellValidating

    Dim headerText As String = _
        dataGridView1.Columns(e.ColumnIndex).HeaderText

    ' Abort validation if cell is not in the CompanyName column.
    If Not headerText.Equals("CompanyName") Then Return

    ' Confirm that the cell is not empty.
    If (String.IsNullOrEmpty(e.FormattedValue.ToString())) Then
        dataGridView1.Rows(e.RowIndex).ErrorText = _
            "Company Name must not be empty"
        e.Cancel = True
    End If
End Sub

Private Sub dataGridView1_CellEndEdit(ByVal sender As Object, _
    ByVal e As System.Windows.Forms.DataGridViewCellEventArgs) _
    Handles dataGridView1.CellEndEdit

    ' Clear the row error in case the user presses ESC.   
    dataGridView1.Rows(e.RowIndex).ErrorText = String.Empty

End Sub

Menguji Aplikasi

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

Untuk menguji formulir

  • Kompilasi dan jalankan aplikasi.

    Anda akan melihat DataGridView diisi dengan data dari tabel Customers. Saat Anda mengklik dua kali sel di kolom CompanyName, Anda bisa mengedit nilainya. Jika Anda menghapus semua karakter dan menekan tombol TAB untuk keluar dari sel, DataGridView mencegah Anda keluar. Saat Anda mengetik string yang tidak kosong ke dalam sel, kontrol DataGridView memungkinkan Anda keluar dari sel.

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