Wskazówki: tworzenie formularza wzorzec/szczegół za pomocą dwóch formantów DataGridView formularzy systemu Windows
Jednym z najbardziej typowych scenariuszy używania kontrolki DataGridView jest formularz wzorca/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.
Implementowanie formularza wzorca/szczegółów jest łatwe przy użyciu interakcji między kontrolką DataGridView a składnikiem BindingSource . W tym przewodniku utworzysz formularz przy użyciu dwóch DataGridView kontrolek i dwóch BindingSource składników. W formularzu zostaną wyświetlone dwie powiązane tabele w przykładowej bazie danych programu SQL Server Northwind: Customers
i Orders
. Po zakończeniu będziesz mieć formularz, który będzie zawierać wszystkich klientów w bazie danych w bazie danych master DataGridView i wszystkie zamówienia dla wybranego klienta w szczegółach DataGridView.
Aby skopiować kod w tym temacie jako pojedynczą listę, zobacz Instrukcje: tworzenie formularza wzorca/szczegółów przy użyciu dwóch kontrolek DataGridView formularzy systemu Windows.
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 wzorca/szczegółów
Utwórz klasę, która pochodzi z Form i zawiera dwie DataGridView kontrolki i dwa BindingSource składniki. 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
GetData
metody, która wypełnia DataSet obiekt, dodaje DataRelation obiekt do zestawu danych i wiąże BindingSource składniki. Pamiętaj, aby ustawićconnectionString
zmienną na wartość odpowiednią dla bazy danych.Ważne
Przechowywanie poufnych informacji, takich jak hasło, w parametry połączenia może mieć wpływ na bezpieczeństwo aplikacji. Korzystanie z uwierzytelniania systemu Windows (znanego również jako zabezpieczenia zintegrowane) jest bezpieczniejszym sposobem na kontrolowanie dostępu do bazy danych. Aby uzyskać więcej informacji, zobacz Ochrona informacji o Połączenie ion.
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 program obsługi zdarzenia formularza Load , który wiąże DataGridView kontrolki ze BindingSource składnikami i wywołuje metodę
GetData
. Poniższy przykład zawiera kod, który zmienia rozmiar DataGridView kolumn 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ę.
Zostaną wyświetlone dwie DataGridView kontrolki, jedna nad drugą. Na górze znajdują się klienci z tabeli Northwind
Customers
, a u dołu odpowiadająOrders
wybranemu klientowi. Po wybraniu różnych wierszy w górnej części DataGridViewzawartość dolnej DataGridView zmienia się odpowiednio.
Następne kroki
Ta aplikacja zapewnia podstawową wiedzę na temat DataGridView możliwości kontrolki. 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 How to: Change the Border and Gridline Styles in the Windows Forms DataGridView Control (Instrukcje: zmienianie stylów obramowania i linii siatki w kontrolce DataGridView formularzy systemu Windows).
Włącz lub ogranicz dane wejściowe użytkownika do kontrolki DataGridView . Aby uzyskać więcej informacji, zobacz Instrukcje: zapobieganie dodawaniu i usuwaniu wierszy w kontrolce DataGridView formularzy systemu Windows oraz Instrukcje: ustawianie kolumn tylko do odczytu w kontrolce DataGridView formularzy systemu Windows.
Zweryfikuj dane wejściowe użytkownika w kontrolce DataGridView . Aby uzyskać więcej informacji, zobacz Przewodnik: 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: implementowanie trybu wirtualnego w kontrolce DataGridView formularzy systemu Windows.
Dostosuj wygląd komórek. Aby uzyskać więcej informacji, zobacz How to: Customize the Appearance of Cells in the Windows Forms DataGridView Control ( Instrukcje: ustawianie domyślnych stylów komórek dla kontrolki DataGridView formularzy systemu Windows).
Zobacz też
.NET Desktop feedback