DataSet.Relations Property

Definition

Gets the collection of relations that link tables and allow navigation from parent tables to child tables.

public:
 property System::Data::DataRelationCollection ^ Relations { System::Data::DataRelationCollection ^ get(); };
public System.Data.DataRelationCollection Relations { get; }
[System.Data.DataSysDescription("DataSetRelationsDescr")]
public System.Data.DataRelationCollection Relations { get; }
member this.Relations : System.Data.DataRelationCollection
[<System.Data.DataSysDescription("DataSetRelationsDescr")>]
member this.Relations : System.Data.DataRelationCollection
Public ReadOnly Property Relations As DataRelationCollection

Property Value

A DataRelationCollection that contains a collection of DataRelation objects. An empty collection is returned if no DataRelation objects exist.

Attributes

Examples

The following example prints the column name of all child tables through the Relations property.

Private Sub PrintChildRelationRows()
   ' Declare variable to hold the row values.
   Dim rowValues As String
   Dim dataSet As DataSet

   ' Get the DataSet of a DataGrid that is displaying data 
   ' of at least two tables.
   Dim table As DataTable = CType(DataGrid1.DataSource, DataTable)

   ' Navigate using the Relations.
   Dim relation As DataRelation
   Dim row As DataRow
   Dim column As DataColumn

   ' Print the names of each column in each table.
   For Each relation In dataSet.Relations
      For Each column in relation.ChildTable.Columns
          rowValues &= column.ColumnName & " "
      Next
    Next

    ' Display results.
    Console.WriteLine(rowValues)
   End Sub

Applies to

See also