Пошаговое руководство. Создание основной или подробной формы с помощью двух элементов управления DataGridView в Windows Forms

Одним из наиболее распространенных сценариев использования элемента управления DataGridView является форма master/detail, в которой отображается связь родительского или дочернего элемента между двумя таблицами базы данных. Выбор строк в главной таблице приводит к обновлению таблицы сведений с соответствующими дочерними данными.

Реализация основной или подробной формы упрощается с помощью взаимодействия между элементом управления DataGridView и компонентом BindingSource. В этом пошаговом руководстве вы создадите форму с помощью двух элементов управления DataGridView и двух компонентов BindingSource. Форма будет отображать две связанные таблицы в образце базы данных SQL Server Northwind: Customers и Orders. По завершении вы получите форму, которая отображает всех клиентов в базе данных в главной DataGridView и все заказы для выбранного клиента в подробной DataGridView.

Чтобы скопировать код в этом разделе в виде единого списка, см. раздел Практическое руководство. Создание основной или подробной формы с помощью двух элементов управления DataGridView в Windows Forms.

Предпосылки

Для выполнения этого пошагового руководства вам потребуется:

Доступ к серверу с примером базы данных SQL Server Northwind.

Создание формы

Создание основной или подробной формы

Создайте класс, производный от Form и содержащий два элемента управления DataGridView и два компонента BindingSource. Следующий код предоставляет базовую инициализацию формы и включает метод Main. Если вы используете конструктор Visual Studio для создания формы, можно использовать созданный конструктором код вместо этого кода, но обязательно используйте имена, отображаемые в объявлениях переменных.

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

Реализуйте метод в определении класса формы для обработки сведений о подключении к базе данных. В этом примере используется метод GetData, заполняющий объект DataSet, добавляет объект DataRelation в набор данных и привязывает компоненты BindingSource. Обязательно задайте для переменной connectionString значение, соответствующее вашей базе данных.

Это важно

Хранение конфиденциальных данных, таких как пароль, в строке подключения может повлиять на безопасность приложения. Использование проверки подлинности Windows (также известной как встроенная безопасность) — это более безопасный способ управления доступом к базе данных. Дополнительные сведения см. в разделе Защита данных о подключении.

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

Реализуйте обработчик события Load формы, который привязывает элементы управления DataGridView к компонентам BindingSource и вызывает метод GetData. В следующем примере содержится код, который изменяет размер столбцов DataGridView для соответствия отображаемым данным.

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

Тестирование приложения

Теперь вы можете протестировать форму, чтобы убедиться, что она работает должным образом.

Тестирование формы

Скомпилируйте и запустите приложение.

Вы увидите два элемента управления DataGridView, один над другим. Сверху клиенты из таблицы Northwind Customers, а внизу — Orders, соответствующие выбранному клиенту. При выборе разных строк в верхнем DataGridViewсодержимое нижнего DataGridView изменится соответствующим образом.

Дальнейшие шаги

Это приложение дает базовое представление о возможностях элемента управления DataGridView. Внешний вид и поведение элемента управления DataGridView можно настроить несколькими способами:

Изменение стилей границ и заголовков. Дополнительные сведения смотрите в разделе Как изменить стили границ и линий сетки в элементе управления Windows Forms DataGridView.
Разрешите или ограничьте ввод пользователей в элемент управления DataGridView. Дополнительные сведения см. в статье Практическое руководство: предотвращение добавления и удаления строк в элементе управления DataGridView в Windows Formsи Практическое руководство: создание столбцов Read-Only в элементе управления DataGridView в Windows Forms.
Проверьте входные данные пользователя в контроле DataGridView. Дополнительные сведения см. в руководстве по пошаговой проверке данных в элементе управления Windows Forms DataGridView.
Обработка очень больших наборов данных с помощью виртуального режима. Дополнительные сведения см. в пошаговом руководстве : Реализация виртуального режима в элементе управления DataGridView Windows Forms.
Настройте внешний вид ячеек. Дополнительные сведения см. в статье Как настроить внешний вид ячеек в элементе управления DataGridView в Windows Forms и Как установить стили ячеек по умолчанию для элемента управления DataGridView в Windows Forms.

См. также

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2025-05-07