DataRow.GetChildRows Method (DataRelation)

 

Gets the child rows of this DataRow using the specified DataRelation.

Namespace:   System.Data
Assembly:  System.Data (in System.Data.dll)

Public Function GetChildRows (
	relation As DataRelation
) As DataRow()

Parameters

relation
Type: System.Data.DataRelation

The DataRelation to use.

Return Value

Type: System.Data.DataRow()

An array of DataRow objects or an array of length zero.

Exception Condition
ArgumentException

The relation and row do not belong to the same table.

ArgumentNullException

The relation is null.

RowNotInTableException

The row does not belong to the table.

VersionNotFoundException

The row does not have this version of data.

The DataTable also contains a collection of DataRelation objects that is returned by the ChildRelations property.

The following example uses the GetChildRows to return the child DataRow objects for every child DataRelation in a DataTable. The value of each column in the row is then printed.

Private Sub GetChildRowsFromDataRelation(table As DataTable)
    Dim relation As DataRelation
    Dim arrRows() As DataRow
    Dim row As DataRow
    Dim i As Integer
    Dim column As DataColumn 

    For Each relation In table.ChildRelations
      For Each row In table.Rows
          arrRows = row.GetChildRows(relation)
          ' Print values of rows.
          For i = 0 To arrRows.GetUpperBound(0)
             For Each column in table.Columns
                Console.WriteLine(arrRows(i)(column))
             Next column
          Next i
       Next row
    Next relation
 End Sub

.NET Framework
Available since 1.1
Return to top
Show: