Dela via

Genomgång: Hantera fel som inträffar under datainmatning i Windows Forms DataGridView-kontrollen

Att hantera fel från det underliggande datalagret är en nödvändig funktion för ett datainmatningsprogram. Kontrollen för Windows Forms DataGridView gör det enkelt genom att exponera händelsen DataError, som utlöses när datalagret upptäcker en begränsningsöverträdelse eller en bruten affärsregel.

I den här genomgången hämtar du rader från tabellen Customers i Northwind-exempeldatabasen och visar dem i en DataGridView kontroll. När ett duplicerat CustomerID värde identifieras på en ny rad eller en redigerad befintlig rad, inträffar den DataError händelsen, som hanteras genom att en MessageBox som beskriver undantaget visas.

Om du vill kopiera koden i det här avsnittet som en enda lista kan du läsa Så här hanterar du fel som inträffar under datainmatning i Windows Forms DataGridView Control.

Förutsättningar

För att slutföra den här genomgången behöver du:

  • Åtkomst till en server som har exempeldatabasen Northwind SQL Server.

Skapa formuläret

Hantera datainmatningsfel i DataGridView-kontrollen

  1. Skapa en klass som härleds från Form och innehåller en DataGridView kontroll och en BindingSource komponent.

    Följande kodexempel innehåller grundläggande initiering och innehåller en Main-metod.

    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. Implementera en metod i formulärets klassdefinition för att hantera information om hur du ansluter till databasen.

    I det här kodexemplet används en GetData-metod som returnerar ett ifyllt DataTable objekt. Se till att du anger variabeln connectionString till ett värde som är lämpligt för databasen.

    Viktigt!

    Lagring av känslig information, till exempel ett lösenord, i anslutningssträngen kan påverka programmets säkerhet. Att använda Windows-autentisering (även kallat integrerad säkerhet) är ett säkrare sätt att styra åtkomsten till en databas. Mer information finns i Skydda anslutningsinformation.

    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. Implementera en hanterare för formulärets Load händelse som initierar DataGridView och BindingSource och konfigurerar databindningen.

    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. Hantera händelsen DataError på DataGridView.

    Om kontexten för felet är en incheckningsåtgärd visar du felet i en MessageBox.

    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

Testa programmet

Nu kan du testa formuläret för att se till att det fungerar som förväntat.

Testa formuläret

  • Tryck på F5 för att köra programmet.

    Du ser en DataGridView kontroll fylld med data från tabellen Kunder. Om du anger ett duplicerat värde för CustomerID och genomför redigeringen återställs cellvärdet automatiskt och du ser en MessageBox som visar datainmatningsfelet.

Nästa steg

Det här programmet ger dig en grundläggande förståelse för funktionerna i DataGridView kontroll. Du kan anpassa utseendet och beteendet för den DataGridView kontrollen på flera sätt:

Se även

  • Last updated on