Procedura dettagliata: creazione di un form Master-Details mediante due controlli DataGridView Windows Form

Articolo
09/12/2008

Aggiornamento: novembre 2007

Uno degli scenari più comuni per l'utilizzo del controllo DataGridView è il form Master-Details, in cui viene visualizzata una relazione padre-figlio tra tabelle di database. Selezionando righe nella tabella master, la tabella dettagli viene aggiornata con i corrispondenti dati figlio.

L'implementazione di un form Master-Details è semplice con l'interazione tra il controllo DataGridView e il componente BindingSource. In questa procedura dettagliata verrà creato il form utilizzando due controlli DataGridView e due componenti BindingSource. Nel form verranno visualizzate due tabelle correlate nel database di esempio Northwind SQL Server: Customers e Orders. Al termine si disporrà di un form in cui vengono visualizzati tutti i clienti contenuti nel database nel controllo DataGridView master e tutti gli ordini di un cliente selezionato nel controllo DataGridView dettagli.

Per copiare il codice nell'argomento corrente come un elenco singolo, vedere Procedura: creare un form Master-Details mediante due controlli DataGridView di Windows Form.

Prerequisiti

Per completare questa procedura dettagliata, è necessario disporre dei seguenti elementi:

Accesso a un server che dispone del database di esempio di SQL Server, Northwind.

Creazione del form

Per creare un form Master-Details

Creare una classe che deriva da Form e contiene due controlli DataGridView e due componenti BindingSource. Il codice riportato di seguito fornisce l'inizializzazione di base del form e include un metodo Main. Se si utilizza la finestra di progettazione Visual Studio per creare il form, è possibile sfruttare il codice generato dalla finestra di progettazione invece di questo codice, tuttavia è necessario assicurarsi di utilizzare i nomi indicati nelle dichiarazioni di variabili descritte di seguito.

Imports System
Imports System.Data
Imports System.Data.SqlClient
Imports System.Windows.Forms

Public Class Form1
    Inherits System.Windows.Forms.Form

    Private masterDataGridView As New DataGridView()
    Private masterBindingSource As New BindingSource()
    Private detailsDataGridView As New DataGridView()
    Private detailsBindingSource As New BindingSource()

    <STAThreadAttribute()> _
    Public Shared Sub Main()
        Application.Run(New Form1())
    End Sub

    ' Initializes the form.
    Public Sub New()

        masterDataGridView.Dock = DockStyle.Fill
        detailsDataGridView.Dock = DockStyle.Fill

        Dim splitContainer1 As New SplitContainer()
        splitContainer1.Dock = DockStyle.Fill
        splitContainer1.Orientation = Orientation.Horizontal
        splitContainer1.Panel1.Controls.Add(masterDataGridView)
        splitContainer1.Panel2.Controls.Add(detailsDataGridView)

        Me.Controls.Add(splitContainer1)
        Me.Text = "DataGridView master/detail demo"

    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 masterDataGridView = new DataGridView();
    private BindingSource masterBindingSource = new BindingSource();
    private DataGridView detailsDataGridView = new DataGridView();
    private BindingSource detailsBindingSource = new BindingSource();

    [STAThreadAttribute()]
    public static void Main()
    {
        Application.Run(new Form1());
    }

    // Initializes the form.
    public Form1()
    {
        masterDataGridView.Dock = DockStyle.Fill;
        detailsDataGridView.Dock = DockStyle.Fill;

        SplitContainer splitContainer1 = new SplitContainer();
        splitContainer1.Dock = DockStyle.Fill;
        splitContainer1.Orientation = Orientation.Horizontal;
        splitContainer1.Panel1.Controls.Add(masterDataGridView);
        splitContainer1.Panel2.Controls.Add(detailsDataGridView);

        this.Controls.Add(splitContainer1);
        this.Load += new System.EventHandler(Form1_Load);
        this.Text = "DataGridView master/detail demo";
    }


...


}

Implementare un metodo nella definizione di classe del form per la gestione dei dettagli della connessione al database. In questo esempio viene utilizzato un metodo GetData che compila un oggetto DataSet, aggiunge un oggetto DataRelation al dataset ed esegue l'associazione dei componenti BindingSource. 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 Sub GetData()

    Try
        ' Specify a connection string. Replace the given value with a 
        ' valid connection string for a Northwind SQL Server sample
        ' database accessible to your system.
        Dim connectionString As String = _
            "Integrated Security=SSPI;Persist Security Info=False;" & _
            "Initial Catalog=Northwind;Data Source=localhost"
        Dim connection As New SqlConnection(connectionString)

        ' Create a DataSet.
        Dim data As New DataSet()
        data.Locale = System.Globalization.CultureInfo.InvariantCulture

        ' Add data from the Customers table to the DataSet.
        Dim masterDataAdapter As _
            New SqlDataAdapter("select * from Customers", connection)
        masterDataAdapter.Fill(data, "Customers")

        ' Add data from the Orders table to the DataSet.
        Dim detailsDataAdapter As _
            New SqlDataAdapter("select * from Orders", connection)
        detailsDataAdapter.Fill(data, "Orders")

        ' Establish a relationship between the two tables.
        Dim relation As New DataRelation("CustomersOrders", _
            data.Tables("Customers").Columns("CustomerID"), _
            data.Tables("Orders").Columns("CustomerID"))
        data.Relations.Add(relation)

        ' Bind the master data connector to the Customers table.
        masterBindingSource.DataSource = data
        masterBindingSource.DataMember = "Customers"

        ' Bind the details data connector to the master data connector,
        ' using the DataRelation name to filter the information in the 
        ' details table based on the current row in the master table. 
        detailsBindingSource.DataSource = masterBindingSource
        detailsBindingSource.DataMember = "CustomersOrders"
    Catch ex As SqlException
        MessageBox.Show("To run this example, replace the value of the " & _
            "connectionString variable with a connection string that is " & _
            "valid for your system.")
    End Try

End Sub

private void GetData()
{
    try
    {
        // Specify a connection string. Replace the given value with a 
        // valid connection string for a Northwind SQL Server sample
        // database accessible to your system.
        String connectionString =
            "Integrated Security=SSPI;Persist Security Info=False;" +
            "Initial Catalog=Northwind;Data Source=localhost";
        SqlConnection connection = new SqlConnection(connectionString);

        // Create a DataSet.
        DataSet data = new DataSet();
        data.Locale = System.Globalization.CultureInfo.InvariantCulture;

        // Add data from the Customers table to the DataSet.
        SqlDataAdapter masterDataAdapter = new
            SqlDataAdapter("select * from Customers", connection);
        masterDataAdapter.Fill(data, "Customers");

        // Add data from the Orders table to the DataSet.
        SqlDataAdapter detailsDataAdapter = new
            SqlDataAdapter("select * from Orders", connection);
        detailsDataAdapter.Fill(data, "Orders");

        // Establish a relationship between the two tables.
        DataRelation relation = new DataRelation("CustomersOrders",
            data.Tables["Customers"].Columns["CustomerID"],
            data.Tables["Orders"].Columns["CustomerID"]);
        data.Relations.Add(relation);

        // Bind the master data connector to the Customers table.
        masterBindingSource.DataSource = data;
        masterBindingSource.DataMember = "Customers";

        // Bind the details data connector to the master data connector,
        // using the DataRelation name to filter the information in the 
        // details table based on the current row in the master table. 
        detailsBindingSource.DataSource = masterBindingSource;
        detailsBindingSource.DataMember = "CustomersOrders";
    }
    catch (SqlException)
    {
        MessageBox.Show("To run this example, replace the value of the " +
            "connectionString variable with a connection string that is " +
            "valid for your system.");
    }
}

Implementare un gestore per l'evento Load del form che associa i controlli DataGridView ai componenti BindingSource e chiama il metodo GetData. Nell'esempio riportato di seguito è incluso il codice che ridimensiona le colonne DataGridView adattandole ai dati visualizzati.

Private Sub Form1_Load(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.Load

    ' Bind the DataGridView controls to the BindingSource
    ' components and load the data from the database.
    masterDataGridView.DataSource = masterBindingSource
    detailsDataGridView.DataSource = detailsBindingSource
    GetData()

    ' Resize the master DataGridView columns to fit the newly loaded data.
    masterDataGridView.AutoResizeColumns()

    ' Configure the details DataGridView so that its columns automatically
    ' adjust their widths when the data changes.
    detailsDataGridView.AutoSizeColumnsMode = _
        DataGridViewAutoSizeColumnsMode.AllCells

End Sub

private void Form1_Load(object sender, System.EventArgs e)
{
    // Bind the DataGridView controls to the BindingSource
    // components and load the data from the database.
    masterDataGridView.DataSource = masterBindingSource;
    detailsDataGridView.DataSource = detailsBindingSource;
    GetData();

    // Resize the master DataGridView columns to fit the newly loaded data.
    masterDataGridView.AutoResizeColumns();

    // Configure the details DataGridView so that its columns automatically
    // adjust their widths when the data changes.
    detailsDataGridView.AutoSizeColumnsMode = 
        DataGridViewAutoSizeColumnsMode.AllCells;
}

Test dell'applicazione

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

Per eseguire il test del form

Compilare ed eseguire l'applicazione.

Verranno visualizzati due controlli DataGridView, disposti verticalmente. Nella parte superiore vi sono i clienti della tabella Customers di Northwind, mentre nella parte inferiore vi sono gli ordini della tabella Orders corrispondenti al cliente selezionato. Selezionando righe diverse nel controllo DataGridView superiore, il contenuto del controllo DataGridView inferiore varia contestualmente.

Passaggi successivi

Questa applicazione fornisce un'idea di massima delle capacità del controllo DataGridView. È possibile personalizzare l'aspetto e il comportamento del controllo DataGridView in diversi modi:

Modificare gli stili di bordi e intestazioni. Per ulteriori informazioni, vedere Procedura: modificare gli stili dei bordi e delle linee della griglia nel controllo DataGridView di Windows Form.
Consentire o limitare l'input utente nel 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.
Convalidare l'input utente nel controllo DataGridView. Per ulteriori informazioni, vedere Procedura dettagliata: convalida di dati nel controllo DataGridView Windows Form.
Gestire dataset di grandi dimensioni utilizzando la modalità virtuale. Per ulteriori informazioni, vedere Procedura dettagliata: implementazione della modalità virtuale nel controllo DataGridView Windows Form.
Personalizzare 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: creazione di un form Master-Details mediante due controlli DataGridView Windows Form

Prerequisiti

Creazione del form

Per creare un form Master-Details

Test dell'applicazione

Per eseguire il test del form

Passaggi successivi

Vedere anche

Attività

Concetti

Riferimenti

Altre risorse

Risorse aggiuntive