Przewodnik: Tworzenie formularza typu master/detail za pomocą dwóch kontrolek DataGridView w formularzach systemu Windows

Jednym z najbardziej typowych scenariuszy używania kontrolki DataGridView jest formularza głównego/szczegółów, w którym jest wyświetlana relacja nadrzędna/podrzędna między dwiema tabelami bazy danych. Wybranie wierszy w tabeli głównej powoduje zaktualizowanie tabeli szczegółów przy użyciu odpowiednich danych podrzędnych.

Tworzenie formularza głównego/szczegółowego jest łatwe przy użyciu interakcji między kontrolką DataGridView a składnikiem BindingSource. W tym przewodniku utworzysz formularz przy użyciu dwóch kontrolek DataGridView i dwóch składników BindingSource. W formularzu zostaną wyświetlone dwie powiązane tabele w przykładowej bazie danych northwind SQL Server: Customers i Orders. Po zakończeniu będziesz mieć formularz przedstawiający wszystkich klientów w bazie danych w sekcji głównej DataGridView oraz wszystkie zamówienia dla wybranego klienta w sekcji szczegółowej DataGridView.

Aby skopiować kod w tym temacie jako jedną listę, zobacz Jak utworzyć formularz główny/szczegóły, używając dwóch kontrolek DataGridView Windows Forms.

Wymagania wstępne

Aby ukończyć ten przewodnik, potrzebne są następujące elementy:

Dostęp do serwera z przykładową bazą danych Northwind SQL Server.

Tworzenie formularza

Aby utworzyć formularz główny/szczegółów

Utwórz klasę, która pochodzi z Form i zawiera dwie kontrolki DataGridView i dwa składniki BindingSource. Poniższy kod zawiera podstawowe inicjowanie formularzy i zawiera metodę Main. Jeśli używasz projektanta programu Visual Studio do utworzenia formularza, możesz użyć wygenerowanego przez projektanta kodu zamiast tego kodu, ale pamiętaj, aby użyć nazw wyświetlanych w deklaracjach zmiennych tutaj.

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

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

Zaimplementuj metodę w definicji klasy formularza do obsługi szczegółów nawiązywania połączenia z bazą danych. W tym przykładzie użyto metody GetData, która wypełnia obiekt DataSet, dodaje obiekt DataRelation do zestawu danych i wiąże składniki BindingSource. Pamiętaj, aby ustawić zmienną connectionString na wartość odpowiednią dla bazy danych.

Ważne

Przechowywanie poufnych informacji, takich jak hasło, w parametrach połączenia może mieć wpływ na bezpieczeństwo aplikacji. Użycie uwierzytelniania systemu Windows (nazywanego również zintegrowanymi zabezpieczeniami) to bezpieczniejszy sposób kontrolowania dostępu do bazy danych. Aby uzyskać więcej informacji, zobacz Ochrona informacji o połączeniu.

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

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

Zaimplementuj procedurę obsługi dla zdarzenia Load formularza, które wiąże kontrolki DataGridView ze składnikami BindingSource i wywołuje metodę GetData. Poniższy przykład zawiera kod, który zmienia rozmiar kolumn DataGridView w celu dopasowania do wyświetlanych danych.

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

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

Testowanie aplikacji

Teraz możesz przetestować formularz, aby upewnić się, że działa zgodnie z oczekiwaniami.

Aby przetestować formularz

Skompiluj i uruchom aplikację.

Będziesz widział dwa elementy sterujące DataGridView, jeden nad drugim. Na górze znajdują się klienci z tabeli Northwind Customers, a u dołu znajdują się Orders odpowiadające wybranemu klientowi. Po wybraniu różnych wierszy w górnej DataGridViewzawartość dolnej DataGridView zmienia się odpowiednio.

Dalsze kroki

Ta aplikacja zapewnia podstawowe zrozumienie możliwości kontroli DataGridView. Wygląd i zachowanie kontrolki DataGridView można dostosować na kilka sposobów:

Zmień style obramowania i nagłówka. Aby uzyskać więcej informacji, zobacz Jak zmienić style granic i linii siatki w kontrolce Windows Forms DataGridView.
Włącz lub ogranicz wprowadzanie danych przez użytkownika do kontrolki DataGridView. Aby uzyskać więcej informacji, zobacz Jak zapobiegać dodawaniu i usuwaniu wierszy w kontrolce DataGridView formularzy Windows, oraz Jak tworzyć kolumny Read-Only w kontrolce DataGridView formularzy Windows.
Zweryfikuj dane wejściowe użytkownika w kontrolce DataGridView. Aby uzyskać więcej informacji, zapoznaj się z przewodnikiem : Weryfikowanie danych w kontrolce DataGridView formularzy systemu Windows.
Obsługa bardzo dużych zestawów danych przy użyciu trybu wirtualnego. Aby uzyskać więcej informacji, zobacz Przewodnik: wdrażanie trybu wirtualnego w kontrolce DataGridView Windows Forms.
Dostosuj wygląd komórek. Aby uzyskać więcej informacji, zobacz Jak: Dostosować wygląd komórek w kontrolce DataGridView Windows Forms oraz Jak: Ustawić domyślne style komórek dla kontrolki DataGridView Windows Forms.

Zobacz także

Sprzężenie zwrotne

Czy ta strona była pomocna?

Last updated on 2025-05-07