Version

GetChildRows(String) Method

Gets the child rows associated with the child band with the specified key in the child bands collection of the row's band.
Syntax
'Declaration
 
Public Overloads Function GetChildRows( _
   ByVal childBandKey As String _
) As UltraDataRowsCollection
public UltraDataRowsCollection GetChildRows( 
   string childBandKey
)

Parameters

childBandKey
Child band key. Child bands collection returned by ChildBands property of this row's band must contain an entry with this key.

Return Value

Returns the child rows.
Remarks

The row's band must have a child band defined with the specified key. The property of the UltraDataBand is used to define the child bands.

Example
Following code shows how to setup an UltraDataSource with some columns and rows. It creates a hiearchical data source with two bands.

Imports Infragistics.Shared
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinDataSource
Imports Infragistics.Win.UltraWinGrid


    Private Sub Form1_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load
        Me.UltraGrid1.DataSource = Me.UltraDataSource1

        ' Add two columns to the root band.
        Me.UltraDataSource1.Band.Columns.Add("Col0", GetType(String))
        Me.UltraDataSource1.Band.Columns.Add("Col1", GetType(String))

        ' Add a child band to the root band with the key of "ChildBand".
        Dim childBand As UltraDataBand = Me.UltraDataSource1.Band.ChildBands.Add("ChildBand")

        ' Add two columns to the child band.
        childBand.Columns.Add("ChildCol0", GetType(String))
        childBand.Columns.Add("ChildCol1", GetType(String))

        ' Set the count on the root rows collection to 2.
        Me.UltraDataSource1.Rows.SetCount(2)

        Dim row As UltraDataRow

        ' Initialize rows with data.

        'Get the first row.
        row = Me.UltraDataSource1.Rows(0)
        row("Col0") = "Row 0, Col 0"
        row("Col1") = "Row 0, Col 1"

        ' Initialize the child rows of the row.
        Dim childRows As UltraDataRowsCollection = row.GetChildRows("ChildBand")
        childRows.SetCount(2)
        childRows(0)("ChildCol0") = "Child Row 0, ChildCol 0"
        childRows(0)("ChildCol1") = "Child Row 0, ChildCol 1"

        childRows(1)("ChildCol0") = "Child Row 1, ChildCol 0"
        childRows(1)("ChildCol1") = "Child Row 1, ChildCol 1"

        ' Get the second row.
        row = Me.UltraDataSource1.Rows(1)
        row("Col0") = "Row 1, Col 0"
        row("Col1") = "Row 1, Col 1"

        ' Initialize the child rows of the row.
        childRows = row.GetChildRows("ChildBand")
        childRows.SetCount(1)
    End Sub
using Infragistics.Shared;
using Infragistics.Win;
using Infragistics.Win.UltraWinDataSource;
using Infragistics.Win.UltraWinGrid;
using System.Diagnostics;


		private void Form1_Load(object sender, System.EventArgs e)
		{
			this.ultraGrid1.DataSource = this.ultraDataSource1;

			// Add two columns to the root band.
			this.ultraDataSource1.Band.Columns.Add( "Col0", typeof( string ) );
			this.ultraDataSource1.Band.Columns.Add( "Col1", typeof( string ) );

			// Add a child band to the root band with the key of "ChildBand".
			UltraDataBand childBand = this.ultraDataSource1.Band.ChildBands.Add( "ChildBand" );

			// Add two columns to the child band.
			childBand.Columns.Add( "ChildCol0", typeof( string ) );
			childBand.Columns.Add( "ChildCol1", typeof( string ) );

			// Set the count on the root rows collection to 2.
			this.ultraDataSource1.Rows.SetCount( 2 );

			UltraDataRow row;

			// Initialize rows with data.

			//Get the first row.
			row = this.ultraDataSource1.Rows[0];
			row[ "Col0" ] = "Row 0, Col 0";
			row[ "Col1" ] = "Row 0, Col 1";

			// Initialize the child rows of the row.
			UltraDataRowsCollection childRows = row.GetChildRows( "ChildBand" );
			childRows.SetCount( 2 );
			childRows[0][ "ChildCol0" ] = "Child Row 0, ChildCol 0";
			childRows[0][ "ChildCol1" ] = "Child Row 0, ChildCol 1";

			childRows[1][ "ChildCol0" ] = "Child Row 1, ChildCol 0";
			childRows[1][ "ChildCol1" ] = "Child Row 1, ChildCol 1";

			// Get the second row.
			row = this.ultraDataSource1.Rows[1];
			row[ "Col0" ] = "Row 1, Col 0";
			row[ "Col1" ] = "Row 1, Col 1";

			// Initialize the child rows of the row.
			childRows = row.GetChildRows( "ChildBand" );
            childRows.SetCount( 1 );
		}
Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also