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

Статья
11/05/2008

Обновлен: Ноябрь 2007

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

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

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

Обязательные компоненты

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

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

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

Создание главного и подчиненного представлений

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

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


...


}

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

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

Хранение в строке подключения конфиденциальных сведений, таких как пароль, может привести к снижению уровня защиты приложения. Использование проверки подлинности Windows (также называемой встроенными средствами безопасности) — более безопасный способ управления доступом к базе данных. Дополнительные сведения см. в разделе Защита сведений о соединении (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.");
    }
}

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

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

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

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

Чтобы проверить форму, выполните следующие действия:

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

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

Следующие действия

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

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

См. также

Поделиться через

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

Обязательные компоненты

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

Создание главного и подчиненного представлений

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

Чтобы проверить форму, выполните следующие действия:

Следующие действия

См. также

Задачи

Основные понятия

Ссылки

Другие ресурсы

Дополнительные ресурсы