Microsoft KB Archive/308052

= How To Display Parent and Child Records in a Windows Forms DataGrid by Using Visual Basic .NET =

Article ID: 308052

Article Last Modified on 3/29/2007

-

APPLIES TO


 * Microsoft .NET Framework 1.1 Service Pack 1
 * Microsoft ADO.NET 1.1
 * Microsoft Visual Basic .NET 2002 Standard Edition
 * Microsoft Visual Basic .NET 2003 Standard Edition
 * Microsoft .NET Framework 1.1
 * Microsoft .NET Framework 1.1

-



This article was previously published under Q308052



For a Microsoft Visual C# .NET version of this article, see 308484.



For a Microsoft Visual Basic 6.0 version of this article, see 185967.

IN THIS TASK
SUMMARY
 * Requirements
 * Understanding the CurrencyManager
 * Create the Project
 * Test the Application

REFERENCES



SUMMARY
This article describes how to create a Windows Form that displays a parent (or master) record and all of the related child (or detail) records by using the Northwind Customers and Orders tables. This article also describes the CurrencyManager object and its purpose.

In this article, the parent record information appears in TextBox controls, and the child record information appears in a DataGrid control. The project that you create in this article also contains Button controls so that you can browse through the records.

back to the top

Requirements
The following list outlines the recommended hardware, software, network infrastructure, and service packs that you need:
 * Microsoft Windows 2000 Professional, Windows 2000 Server, Windows 2000 Advanced Server, or Windows NT 4.0 Server
 * Microsoft SQL Server version 7.0 or 2000, or Microsoft Data Engine (MSDE) with the Northwind sample database installed
 * Microsoft Visual Studio .NET

back to the top

Understanding the CurrencyManager
It is important that you understand the function of the CurrencyManager object to help you follow the sample in this article. Any data source that you bind to in a Windows Forms control contains an associated CurrencyManager object. The CurrencyManager object monitors the position and otherwise supervises bindings to that data source. The form contains a CurrencyManager object for each discrete data source to which you are binding. If all of the controls on the form bind to a single source (for example, if several TextBox controls are bound to the same data table), they share the same CurrencyManager. When the controls on the form are bound to different sources, the form contains multiple CurrencyManager objects, each of which tracks which record or data element the controls are using.

back to the top

Create the Project
This section describes how to create the project that demonstrates this functionality.  Start Visual Studio .NET, and create a new Visual Basic Windows Application project. Add three TextBox controls, five Button controls, and one DataGrid control to the default form. Change the Text properties of the Button controls to Fill, First , Next , Previous , and Last .  Switch to Code view, and add the following statement to the top of the Code window: Imports System.Data.SqlClient   Add the following member variable to the Form1 class after the Inherits statement: Dim cm as CurrencyManager   Switch to Form view, and double-click Fill. Add the following code to the Click event: ' Get the data. Dim con as New SqlConnection(&quot;server=<YourServer>;uid=<your_user_id>;&quot; & _                            &quot;pwd=<your_password>;database=northwind&quot;) Dim daCust as New SqlDataAdapter(&quot;Select * from Customers&quot;, con) Dim daOrders as New SqlDataAdapter(&quot;Select * from Orders&quot;,con) Dim ds as New DataSet daCust.Fill(ds,&quot;Cust&quot;) daOrders.Fill(ds,&quot;Orders&quot;) ds.Relations.Add(&quot;CustOrd&quot;,ds.Tables!Cust.Columns!CustomerID,_ ds.Tables!Orders.Columns!CustomerID) ' 'Bind the controls. ' TextBox1.DataBindings.Add(&quot;Text&quot;, ds.Tables!Cust,&quot;CustomerID&quot;) TextBox2.DataBindings.Add(&quot;Text&quot;, ds.Tables!Cust,&quot;CompanyName&quot;) TextBox3.DataBindings.Add(&quot;Text&quot;, ds.Tables!Cust,&quot;ContactName&quot;) DataGrid1.DataSource=ds.Tables!Cust DataGrid1.DataMember=&quot;CustOrd&quot; ' 'Initialize the CurrencyManager. ' cm=CType(Me.BindingContext(ds.Tables!Cust),CurrencyManager) </li> Modify the connection string as appropriate for your environment.</li>  Double-click First, and add the following code to the Click event: If Not (cm Is Nothing) AndAlso cm.Count Then cm.Position = 0 </li>  Double-click Next, and add the following code to the Click event: If Not (cm Is Nothing) AndAlso cm.Count AndAlso cm.Position <cm.Count -1 Then cm.Position +=1 </li>  Double-click Previous, and add the following code to the Click event: If Not (cm Is Nothing) AndAlso cm.Count AndAlso cm.Position >0 Then cm.Position -=1 </li>  Double-click Last, and add the following code to the Click event: If Not (cm Is Nothing) AndAlso cm.Count Then cm.Position=cm.Count-1 </li></ol>

back to the top

Test the Application

 * 1) Press the F5 key to compile and run the application. Note that the form is initially empty.
 * 2) Click Fill to load and bind the data, and use the navigation buttons to move through the data.

back to the top

<div class="references_section">