İzlenecek yol: Windows Forms DataGridView Denetiminde Verileri Doğrulama
Kullanıcılara veri girişi işlevselliğini görüntülerken, sık sık formunuza girilen verileri doğrulamanız gerekir. sınıfı, DataGridView veriler veri deposuna işlenmeden önce doğrulama gerçekleştirmek için kullanışlı bir yol sağlar. Geçerli hücre değiştiğinde CellValidating tarafından tetiklenen olayı işleyerek DataGridView verileri doğrulayabilirsiniz.
Bu kılavuzda, Northwind örnek veritabanındaki tablodan Customers
satırlar alacak ve bunları bir DataGridView denetimde görüntüleyeceksiniz. Kullanıcı sütundaki bir hücreyi CompanyName
düzenlediğinde ve hücreden ayrılmaya çalıştığında, CellValidating olay işleyicisi boş olmadığından emin olmak için yeni şirket adı dizesini inceler; yeni değer boş bir dizeyse, DataGridView boş olmayan bir dize girilene kadar kullanıcının imlecinin hücreden çıkmasını engeller.
Bu konudaki kodu tek bir liste olarak kopyalamak için bkz . Nasıl yapılır: Windows Forms DataGridView Denetiminde Verileri Doğrulama.
Ön koşullar
Bu kılavuzu tamamlamak için şunlar gerekir:
- Northwind SQL Server örnek veritabanına sahip bir sunucuya erişim.
Form Oluşturma
DataGridView'a girilen verileri doğrulamak için
öğesinden Form türetilen ve bir denetim ve bileşen içeren bir DataGridViewBindingSource sınıf oluşturun.
Aşağıdaki kod örneği temel başlatma sağlar ve bir
Main
yöntem içerir.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
Veritabanına bağlanma ayrıntılarını işlemek için formunuzun sınıf tanımında bir yöntem uygulayın.
Bu kod örneği, doldurulmuş DataTable bir
GetData
nesne döndüren bir yöntem kullanır. değişkeniniconnectionString
veritabanınıza uygun bir değere ayarladığınızdan emin olun.Önemli
Parola gibi hassas bilgilerin bağlantı dizesi depolanması uygulamanızın güvenliğini etkileyebilir. Tümleşik güvenlik olarak da bilinen Windows Kimlik Doğrulaması'nın kullanılması, veritabanına erişimi denetlemenin daha güvenli bir yoludur. Daha fazla bilgi için bkz. Bağlan Bilgilerini Koruma.
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
Ve'yi Load başlatan ve veri bağlamasını DataGridViewBindingSource ayarlayan formunuzun olayı için bir işleyici uygulayın.
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
Denetimin CellValidating ve CellEndEdit olaylarının DataGridView işleyicilerini uygulayın.
Olay CellValidating işleyicisi, sütundaki
CompanyName
bir hücrenin değerinin boş olup olmadığını saptadığınız yerdir. Hücre değeri doğrulamada başarısız olursa, sınıfının özelliğini System.Windows.Forms.DataGridViewCellValidatingEventArgs olaraktrue
ayarlayınCancel. Bu, denetimin DataGridView imlecin hücreden çıkmasını engellemesine neden olur. Satırdaki ErrorText özelliğini açıklayıcı bir dize olarak ayarlayın. Bu, hata metnini içeren araç ipucu içeren bir hata simgesi görüntüler. Olay işleyicisinde CellEndEdit , satırdaki özelliğini boş dizeye ayarlayın ErrorText . Olay CellEndEdit yalnızca hücre düzenleme modundan çıktığında gerçekleşir ve doğrulama başarısız olursa bunu yapamaz.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
Uygulamayı Test Etme
Artık formu test edebilir ve beklendiği gibi davrandığından emin olabilirsiniz.
Formu test etmek için
Uygulamayı derleyin ve çalıştırın.
Tablodan
Customers
verilerle dolu bir DataGridView veri görürsünüz. Sütundaki bir hücreyeCompanyName
çift tıkladığınızda, değeri düzenleyebilirsiniz. Tüm karakterleri siler ve hücreden çıkmak için SEKME tuşuna bastığınızda, DataGridView hücreden çıkmanızı engeller. Hücreye boş olmayan bir dize yazdığınızda DataGridView , denetim hücreden çıkmanızı sağlar.
Sonraki Adımlar
Bu uygulama, denetimin DataGridView özellikleri hakkında temel bilgiler sağlar. Denetimin görünümünü ve davranışını DataGridView çeşitli yollarla özelleştirebilirsiniz:
Kenarlık ve üst bilgi stillerini değiştirin. Daha fazla bilgi için bkz . Nasıl yapılır: Windows Forms DataGridView Denetiminde Kenarlık ve Kılavuz Çizgisi Stillerini Değiştirme.
Denetime DataGridView kullanıcı girişini etkinleştirin veya kısıtlayın. Daha fazla bilgi için bkz . How to: Prevent Row Addition and Deletion in the Windows Forms DataGridView Control ve How to: Make Columns Read-Only in the Windows Forms DataGridView Control.
Veritabanıyla ilgili hatalar için kullanıcı girişini denetleyin. Daha fazla bilgi için bkz . İzlenecek Yol: Windows Forms DataGridView Denetiminde Veri Girişi Sırasında Oluşan Hataları İşleme.
Sanal modu kullanarak çok büyük veri kümelerini işleyin. Daha fazla bilgi için bkz . İzlenecek Yol: Windows Forms DataGridView Denetiminde Sanal Modu Uygulama.
Hücrelerin görünümünü özelleştirin. Daha fazla bilgi için bkz. Nasıl yapılır: Windows Forms DataGridView Denetiminde Hücrelerin Görünümünü Özelleştirme ve Nasıl Yapılır: Windows Forms DataGridView Denetiminde Yazı Tipi ve Renk Stillerini Ayarlama.
Ayrıca bkz.
.NET Desktop feedback
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin