İzlenecek yol: Windows Forms DataGridView Denetimine Veri Girişi Sırasında Oluşan Hataları Ele Alma

Temel alınan veri deposu hatalarını işleme, veri girişi uygulaması için gerekli bir özelliktir. Windows Forms denetimi, veri deposu bir kısıtlama ihlali veya bozuk bir iş kuralı algılayan olayı ortaya çıkararak DataGridViewDataError bunu kolaylaştırır.

Bu kılavuzda Northwind örnek Customers veritabanındaki tablodan satırlar alır ve bunları bir denetimde DataGridView görüntülersiniz. Yeni bir satırda veya düzenlenen bir mevcut satırda yinelenen bir değer algılandığında, olay oluşur ve bu olay, özel durumu açıklayan bir CustomerIDDataErrorMessageBox görüntüleyerek işleniyor.

Bu konudaki kodu tek bir liste olarak kopyalamak için bkz. How to: Handle Errors That Occur Errors During Data Entry in Windows Forms DataGridView Control.

Önkoşullar

Bu izlenecek yolu tamamlamak için aşağıdakiler gerekir:

  • Northwind veritabanına sahip bir sunucuya erişim SQL Server veritabanı.

Form Oluşturma

DataGridView denetiminde veri girişi hatalarını işlemek için

  1. 'den türeten ve bir Form denetim ve bileşen içeren bir sınıf DataGridViewBindingSource oluşturun.

    Aşağıdaki kod örneği temel başlatma sağlar ve bir yöntemi Main 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);
        }
    
    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. Veritabanına bağlanma ayrıntılarını işlemeye ilişkin form sınıf tanımında bir yöntem uygulama.

    Bu kod örneği doldurulmuş GetData bir nesne döndüren bir yöntem DataTable kullanır. değişkenini veritabanınız connectionString için uygun bir değere ayarlayasınız.

    Önemli

    Bağlantı dizesi içinde parola gibi hassas bilgilerin depolanması, uygulamanın güvenliğini etkileyebilir. Windows Kimlik Doğrulaması (tümleşik güvenlik olarak da bilinir) kullanılarak bir veritabanına erişimi denetlemek için daha güvenli bir yoldur. Daha fazla bilgi için bkz. Bağlantı 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, 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. Ve'i başlatan ve veri bağlamayı ayaran form olay LoadDataGridView için bir BindingSource işleyici uygulama.

    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. olayı DataError üzerinde DataGridView işle.

    Hatanın bağlamı bir işleme işlemi ise, hatayı bir içinde MessageBox görüntüler.

    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
    

Uygulamayı Test Etme

Artık formu test etmek için beklendiği gibi davranarak emin olun.

Formu test etmek için

  • Uygulamayı çalıştırmak için F5'e basın.

    Customers tablosundan DataGridView gelen verilerle doldurulmuş bir denetim görüyorsunuz. için yinelenen bir değer girer ve düzenlemeyi işlerseniz hücre değeri otomatik olarak geri döner ve veri girişi hatasını görüntüleyen CustomerIDMessageBox bir görüntülenir.

Sonraki Adımlar

Bu uygulama, denetimin özellikleri hakkında DataGridView temel bir anlayış sağlar. Denetimin görünümünü ve davranışını çeşitli DataGridView yollarla özelleştirebilirsiniz:

Ayrıca bkz.