Procedura dettagliata: gestione degli errori che si verificano durante l'immissione di dati nel controllo DataGridView Windows Form

Articolo
09/12/2008

Aggiornamento: novembre 2007

La gestione degli errori derivanti dall'archivio dati sottostante è una funzionalità necessaria per un'applicazione di immissione dati. Il controllo DataGridView di Windows Form semplifica questa attività esponendo l'evento DataError, che viene generato quando nell'archivio dati viene rilevata una violazione dei vincoli o di una regola business.

In questa procedura dettagliata verranno recuperate righe dalla tabella Customers del database di esempio Northwind. Queste righe verranno visualizzate in un controllo DataGridView. Quando viene rilevato un valore di riga duplicata CustomerID in una nuova riga o in una riga già presente e modificata, viene generato l'evento DataError, la cui gestione è possibile mediante la visualizzazione della classe MessageBox in cui è descritta l'eccezione.

Per copiare il codice nell'argomento corrente come un elenco singolo, vedere Procedura: gestire gli errori che si verificano durante l'immissione di dati nel controllo DataGridView di Windows Form.

Prerequisiti

Per completare questa procedura dettagliata è necessario:

Accedere a un server in cui sia presente il database di esempio Northwind SQL Server.

Creazione del form

Per gestire gli errori di immissione dei dati nel controllo DataGridView

Creare una classe derivante dalla classe Form e che contenga un controllo DataGridView e un componente BindingSource.

Nell'esempio di codice riportato di seguito viene fornita l'inizializzazione di base e viene incluso un metodo Main.

Imports System
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()> _
    Shared Sub Main()
        Application.EnableVisualStyles()
        Application.Run(New Form1())
    End Sub

End Class

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);
    }


...


    [STAThread]
    static void Main()
    {
        Application.EnableVisualStyles();
        Application.Run(new Form1());
    }

}

Implementare un metodo nella definizione della classe del form per gestire i dettagli della connessione al database.

Nell'esempio di codice viene utilizzare un metodo GetData che restituisce un oggetto DataTable che contiene dati. Accertarsi di impostare la variabile connectionString su un valore appropriato per il database in uso.

Nota sulla sicurezza:
L'archiviazione delle informazioni riservate, ad esempio la password, nella stringa di connessione può avere implicazioni sulla protezione dell'applicazione. L'autenticazione di Windows, detta anche protezione integrata, consente di controllare l'accesso a un database in modo più sicuro. Per ulteriori informazioni, vedere Protezione delle informazioni di connessione (ADO.NET).

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

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;
}

Implementare un gestore per l'evento Load del form in uso per inizializzare le classi DataGridView e BindingSource e impostare l'associazione dati.

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

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);
}

Gestire l'evento DataError nella classe DataGridView.

Se il contesto dell'errore è un'operazione di commit, visualizzare l'errore in una classe MessageBox.

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

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.");
    }
}

Test dell'applicazione

È ora possibile verificare il form per assicurarsi che funzioni correttamente.

Per eseguire il test del form

Premere F5 per eseguire l'applicazione.

Verrà visualizzato un controllo DataGridView in cui sono presenti i dati della tabella Customers. Se si inserisce un valore duplicato per CustomerID e si esegue il commit della modifica, il valore della cella verrà annullato automaticamente e verrà visualizzata una classe MessageBox in cui è presente l'errore di immissione dati.

Passaggi successivi

Questa applicazione fornisce elementi di base per comprendere le capacità del controllo DataGridView. È possibile personalizzare l'aspetto e il comportamento del controllo DataGridView in diversi modi:

Modificando gli stili dei bordi e dell'intestazione. Per ulteriori informazioni, vedere Procedura: modificare gli stili dei bordi e delle linee della griglia nel controllo DataGridView di Windows Form.
Abilitando o limitando l'input dell'utente al controllo DataGridView. Per ulteriori informazioni, vedere Procedura: impedire l'aggiunta o l'eliminazione di righe nel controllo DataGridView di Windows Form e Procedura: impostare le colonne come in sola lettura nel controllo DataGridView di Windows Form.
Convalidando l'input dell'utente nel controllo DataGridView. Per ulteriori informazioni, vedere Procedura dettagliata: convalida di dati nel controllo DataGridView Windows Form.
Gestendo serie di dati molto grandi utilizzando la modalità virtuale. Per ulteriori informazioni, vedere Procedura dettagliata: implementazione della modalità virtuale nel controllo DataGridView Windows Form.
Personalizzando l'aspetto delle celle. Per ulteriori informazioni, vedere Procedura: personalizzare l'aspetto delle celle nel controllo DataGridView di Windows Form e Procedura: impostare stili di cella predefiniti per il controllo DataGridView di Windows Form.

Vedere anche

Condividi tramite

Procedura dettagliata: gestione degli errori che si verificano durante l'immissione di dati nel controllo DataGridView Windows Form

Prerequisiti

Creazione del form

Per gestire gli errori di immissione dei dati nel controllo DataGridView

Test dell'applicazione

Per eseguire il test del form

Passaggi successivi

Vedere anche

Attività

Concetti

Riferimenti

Altre risorse

Risorse aggiuntive