Panduan: Memvalidasi Data di Formulir Windows Kontrol DataGridView
Saat Anda menampilkan fungsionalitas entri data kepada pengguna, Anda sering harus memvalidasi data yang dimasukkan ke dalam formulir Anda. Kelas ini DataGridView menyediakan cara mudah untuk melakukan validasi sebelum data diterapkan ke penyimpanan data. Anda dapat memvalidasi data dengan menangani CellValidating peristiwa, yang dimunculkan oleh DataGridView saat sel saat ini berubah.
Dalam panduan ini, Anda akan mengambil baris dari Customers
tabel dalam database sampel Northwind dan menampilkannya dalam DataGridView kontrol. Saat pengguna mengedit sel di CompanyName
kolom dan mencoba meninggalkan sel, CellValidating penanganan aktivitas 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 satu daftar, lihat Cara: Memvalidasi Data di Formulir Windows Kontrol 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
Buat kelas yang berasal dari Form dan berisi DataGridView kontrol dan BindingSource komponen.
Contoh kode berikut menyediakan inisialisasi dasar dan menyertakan
Main
metode .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
Terapkan metode dalam definisi kelas formulir Anda untuk menangani detail menyambungkan ke database.
Contoh kode ini menggunakan
GetData
metode yang mengembalikan objek yang diisi DataTable . Pastikan Anda mengatur variabel keconnectionString
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 lebih lengkap, 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
Terapkan handler untuk peristiwa formulir Load Anda yang menginisialisasi DataGridView dan BindingSource 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
Terapkan DataGridView handler untuk kontrol CellValidating dan CellEndEdit peristiwa.
Penanganan CellValidating aktivitas adalah tempat Anda menentukan apakah nilai sel dalam
CompanyName
kolom kosong. Jika nilai sel gagal validasi, atur Cancel properti kelas ke System.Windows.Forms.DataGridViewCellValidatingEventArgstrue
. Hal ini menyebabkan DataGridView kontrol mencegah kursor meninggalkan sel. Atur ErrorText properti pada baris ke string penjelasan. Ini menampilkan ikon kesalahan dengan TipsAlat yang berisi teks kesalahan. Di penanganan CellEndEdit aktivitas, atur ErrorText properti pada baris ke 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 data yang DataGridView diisi dari
Customers
tabel. Saat Anda mengeklik dua kali sel diCompanyName
kolom, 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, DataGridView kontrol memungkinkan Anda keluar dari sel.
Langkah berikutnya
Aplikasi ini memberi Anda pemahaman DataGridView dasar tentang kemampuan kontrol. Anda dapat menyesuaikan tampilan dan perilaku kontrol dengan DataGridView beberapa cara:
Ubah gaya batas dan header. Untuk informasi selengkapnya, lihat Cara: Mengubah Gaya Batas dan Garis Kisi di Kontrol Formulir Windows DataGridView.
Aktifkan atau batasi input pengguna ke DataGridView kontrol. Untuk informasi selengkapnya, lihat Cara: Mencegah Penambahan dan Penghapusan Baris di Kontrol Formulir Windows DataGridView, dan Cara: Membuat Kolom Baca-Saja di Formulir Windows Kontrol DataGridView.
Periksa input pengguna untuk kesalahan terkait database. Untuk informasi selengkapnya, lihat Panduan: Menangani Kesalahan yang Terjadi Selama Entri Data di kontrol Formulir Windows DataGridView.
Tangani himpunan data yang sangat besar menggunakan mode virtual. Untuk informasi selengkapnya, lihat Panduan: Menerapkan Mode Virtual di Formulir Windows Kontrol DataGridView.
Sesuaikan tampilan sel. Untuk informasi selengkapnya, lihat Cara: Menyesuaikan Tampilan Sel di Formulir Windows Kontrol DataGridView dan Cara: Mengatur Gaya Font dan Warna di Kontrol Formulir Windows DataGridView.
Baca juga
.NET Desktop feedback
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk