İzlenecek yol: İki Windows Forms DataGridView Denetimi Kullanarak Ana/Ayrıntı Formu Oluşturma

Makale
10/18/2023

Denetimi kullanmak DataGridView için en yaygın senaryolardan biri, iki veritabanı tablosu arasındaki üst/alt ilişkinin görüntülendiği ana/ayrıntı formudur. Ana tabloda satırların seçilmesi, ayrıntı tablosunun ilgili alt verilerle güncelleştirililmesine neden olur.

Denetim ile BindingSource bileşen arasındaki DataGridView etkileşimi kullanarak bir ana/ayrıntı formu uygulamak kolaydır. Bu kılavuzda, formu iki denetim ve iki DataGridView BindingSource bileşen kullanarak oluşturacaksınız. Formda Northwind SQL Server örnek veritabanında iki ilişkili tablo gösterilir: Customers ve Orders. İşiniz bittiğinde, veritabanındaki tüm müşterileri ana DataGridView veritabanında ve seçili müşteri için tüm siparişleri ayrıntılı DataGridViewolarak gösteren bir formunuz olur.

Bu konudaki kodu tek bir liste olarak kopyalamak için bkz . Nasıl yapılır: İki Windows Forms DataGridView Denetimi Kullanarak Ana/Ayrıntı Formu Oluşturma.

Ön koşullar

Bu kılavuzu tamamlamak için şunlar gerekir:

Northwind SQL Server örnek veritabanına sahip bir sunucuya erişim.

Formu oluşturma

Ana/ayrıntı formu oluşturmak için

öğesinden Form türetilen ve iki DataGridView denetim ve iki BindingSource bileşen içeren bir sınıf oluşturun. Aşağıdaki kod temel form başlatma sağlar ve bir Main yöntem içerir. Formunuzu oluşturmak için Visual Studio tasarımcısı kullanıyorsanız, bu kod yerine tasarımcı tarafından oluşturulan kodu kullanabilirsiniz, ancak buradaki değişken bildirimlerinde gösterilen adları kullandığınızdan emin olun.

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

Veritabanına bağlanma ayrıntılarını işlemek için formunuzun sınıf tanımında bir yöntem uygulayın. Bu örnekte bir GetData nesneyi dolduranDataSet, veri kümesine nesne ekleyen ve bileşenleri bağlayan BindingSource bir DataRelation yöntem kullanılır. değişkeni veritabanınıza connectionString uygun bir değere ayarladığınızdan emin olun.

Önemli

Parola gibi hassas bilgilerin bağlantı dizesi depolanması uygulamanızın güvenliğini etkileyebilir. Windows Kimlik Doğrulaması (tümleşik güvenlik olarak da bilinir) kullanılarak bir veritabanına erişimi denetlemek için daha güvenli bir yoldur. Daha fazla bilgi için bkz. Bağlan Bilgilerini Koruma.

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

Formunuzun Load olayı için denetimleri bileşenlere BindingSource bağlayan DataGridView ve yöntemini çağıran bir işleyici uygulayınGetData. Aşağıdaki örnek, görüntülenen verilere sığacak şekilde sütunları yeniden boyutlandıran DataGridView kodu içerir.

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

Uygulamayı Test Etme

Artık formu test edebilir ve beklendiği gibi davrandığından emin olabilirsiniz.

Formu test etmek için

Uygulamayı derleyin ve çalıştırın.

Biri diğerinin üzerinde iki DataGridView denetim görürsünüz. En üstte Northwind Customers tablosundaki müşteriler ve en altta seçili müşteriye karşılık gelen müşteriler bulunur Orders . Üstteki DataGridViewfarklı satırları seçtiğinizde, alt DataGridView satırın içeriği buna göre değişir.

Sonraki Adımlar

Bu uygulama, denetimin DataGridView özellikleri hakkında temel bilgiler sağlar. Denetimin görünümünü ve davranışını DataGridView çeşitli yollarla özelleştirebilirsiniz:

Kenarlık ve üst bilgi stillerini değiştirin. Daha fazla bilgi için bkz . Nasıl yapılır: Windows Forms DataGridView Denetiminde Kenarlık ve Kılavuz Çizgisi Stillerini Değiştirme.
Denetime DataGridView kullanıcı girişini etkinleştirin veya kısıtlayın. Daha fazla bilgi için bkz . How to: Prevent Row Addition and Deletion in the Windows Forms DataGridView Control ve How to: Make Columns Read-Only in the Windows Forms DataGridView Control.
Denetime DataGridView kullanıcı girişini doğrulayın. Daha fazla bilgi için bkz . İzlenecek Yol: Windows Forms DataGridView Denetiminde Verileri Doğrulama.
Sanal modu kullanarak çok büyük veri kümelerini işleyin. Daha fazla bilgi için bkz . İzlenecek Yol: Windows Forms DataGridView Denetiminde Sanal Modu Uygulama.
Hücrelerin görünümünü özelleştirin. Daha fazla bilgi için bkz. Nasıl yapılır: Windows Forms DataGridView Denetiminde Hücrelerin Görünümünü Özelleştirme ve Nasıl Yapılır: Windows Forms DataGridView Denetimi için Varsayılan Hücre Stillerini Ayarlama.