Freigeben über

Anleitung: Erstellen eines Master-/Detailformulars mithilfe von zwei Windows Forms DataGridView-Steuerelementen

Eines der häufigsten Szenarien für die Verwendung des DataGridView Steuerelements ist das Master-Detail-Formular, in dem eine übergeordnete/untergeordnete Beziehung zwischen zwei Datenbanktabellen angezeigt wird. Wenn Sie Zeilen in der Mastertabelle auswählen, wird die Detailtabelle mit den entsprechenden untergeordneten Daten aktualisiert.

Das Implementieren eines Master-/Detailformulars ist einfach mit der Interaktion zwischen dem DataGridView Steuerelement und der BindingSource Komponente. In dieser exemplarischen Vorgehensweise erstellen Sie das Formular mit zwei DataGridView Steuerelementen und zwei BindingSource Komponenten. Das Formular zeigt zwei verwandte Tabellen in der Northwind SQL Server-Beispieldatenbank an: Customers und Orders. Wenn Sie fertig sind, haben Sie ein Formular, in dem alle Kunden in der Datenbank im Master DataGridView und alle Bestellungen für den ausgewählten Kunden im Detail DataGridViewangezeigt werden.

Informationen zum Kopieren des Codes in diesem Thema als einzelne Auflistung finden Sie unter How to: Create a Master/Detail Form Using Two Windows Forms DataGridView Controls.

Voraussetzungen

Für die Durchführung dieser exemplarischen Vorgehensweise benötigen Sie Folgendes:

  • Zugriff auf einen Server mit der Northwind SQL Server-Beispieldatenbank.

Erstellen des Formulars

So erstellen Sie ein Master-/Detailformular

  1. Erstellen Sie eine Klasse, die von Form abgeleitet ist und zwei DataGridView Steuerelemente sowie zwei BindingSource Komponenten enthält. Der folgende Code stellt die grundlegende Formularinitialisierung bereit und enthält eine Main Methode. Wenn Sie den Visual Studio-Designer zum Erstellen Ihres Formulars verwenden, können Sie anstelle dieses Codes den generierten Code des Designers verwenden. Achten Sie jedoch darauf, die hier in den Variablendeklarationen angezeigten Namen zu verwenden.

    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

  2. Implementieren Sie eine Methode in der Klassendefinition Ihres Formulars, um die Details der Verbindung mit der Datenbank zu behandeln. In diesem Beispiel wird eine GetData Methode verwendet, die ein DataSet Objekt auffüllt, dem Dataset ein DataRelation Objekt hinzufügt und die BindingSource Komponenten bindet. Achten Sie darauf, die connectionString Variable auf einen Wert festzulegen, der für Ihre Datenbank geeignet ist.

    Von Bedeutung

    Das Speichern vertraulicher Informationen, z. B. eines Kennworts, innerhalb der Verbindungszeichenfolge kann sich auf die Sicherheit Ihrer Anwendung auswirken. Die Verwendung der Windows-Authentifizierung (auch als integrierte Sicherheit bezeichnet) ist eine sicherere Möglichkeit, den Zugriff auf eine Datenbank zu steuern. Weitere Informationen finden Sie unter Schützen von Verbindungsinformationen.

    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

  3. Implementieren Sie einen Handler für das Formularereignis Load , das die Steuerelemente an die DataGridViewBindingSource Komponenten bindet und die GetData Methode aufruft. Das folgende Beispiel enthält Code, mit dem die Größe DataGridView von Spalten an die angezeigten Daten angepasst wird.

    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

Testen der Anwendung

Sie können das Formular jetzt testen, um sicherzustellen, dass es sich wie erwartet verhält.

So testen Sie das Formular

  • Kompilieren Sie die Anwendung, und führen Sie sie aus.

    Es werden zwei DataGridView Steuerelemente angezeigt, die sich über dem anderen befinden. Oben befinden sich die Kunden aus der Northwind Tabelle Customers, und unten sind die Orders Entsprechungen für den ausgewählten Kunden. Wenn Sie unterschiedliche Zeilen im oberen DataGridViewBereich auswählen, ändern sich die Inhalte der unteren DataGridView Zeile entsprechend.

Nächste Schritte

Diese Anwendung vermittelt Ihnen ein grundlegendes Verständnis der Möglichkeiten des DataGridView-Steuerelements. Sie können das Erscheinungsbild und Verhalten des DataGridView Steuerelements auf verschiedene Arten anpassen:

Siehe auch

  • Last updated on