Share via

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

  • Makale

Temel alınan veri deposundaki hataların işlenmesi, veri girişi uygulaması için gerekli bir özelliktir. Windows Forms DataGridView denetimi, veri deposu bir kısıtlama ihlali veya bozuk bir iş kuralı algıladığında ortaya çıkan olayı ortaya DataError çıkararak bunu kolaylaştırır.

Bu kılavuzda, Northwind örnek veritabanındaki tablodan Customers satırlar alacak ve bunları bir DataGridView denetimde görüntüleyeceksiniz. Yeni bir satırda veya düzenlenmiş bir satırda yinelenen CustomerID bir değer algılandığında, DataError olay gerçekleşir ve bu durum özel durumu açıklayan bir MessageBox görüntülenerek işlenir.

Bu konudaki kodu tek bir liste olarak kopyalamak için bkz . Nasıl yapılır: Windows Forms DataGridView Denetiminde Veri Girişi Sırasında Oluşan Hataları İşleme.

Ö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 denetimindeki veri girişi hatalarını işlemek için

  1. öğ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);
    }

    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ş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şkenini connectionString 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. 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ğ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, 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'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 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. DataError üzerindeki olayı işleyebilirDataGridView.

    Hatanın bağlamı bir işleme işlemiyse, hatasını içinde MessageBoxgörüntüleyin.

    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 edebilir ve beklendiği gibi davrandığından emin olabilirsiniz.

Formu test etmek için

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

    Müşteriler tablosundaki verilerle dolu bir DataGridView denetim görürsünüz. için CustomerID 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 bir MessageBox değer görürsünüz.

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:

Ayrıca bkz.