Export (0) Print
Expand All

DataRelation Constructor (String, DataColumn(), DataColumn())

Initializes a new instance of the DataRelation class using the specified DataRelation name and matched arrays of parent and child DataColumn objects.

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

'Declaration
Public Sub New ( _
	relationName As String, _
	parentColumns As DataColumn(), _
	childColumns As DataColumn() _
)

Parameters

relationName
Type: System.String

The name of the relation. If Nothing or an empty string (""), a default name will be given when the created object is added to the DataRelationCollection.

parentColumns
Type: System.Data.DataColumn()

An array of parent DataColumn objects.

childColumns
Type: System.Data.DataColumn()

An array of child DataColumn objects.

ExceptionCondition
ArgumentNullException

One or both of the DataColumn objects contains Nothing.

InvalidConstraintException

The DataColumn objects have different data types

-Or-

One or both of the arrays are not composed of distinct columns from the same table.

-Or-

The tables do not belong to the same DataSet.

The following example creates a new DataRelation and adds it to the DataRelationCollection of a DataSet.

Private Sub CreateRelation()
    ' Code to get the DataSet not shown here. 
    ' Get the DataColumn objects from two DataTable  
    ' objects in a DataSet. 
    Dim parentColumns() As DataColumn
    Dim childColumns() As DataColumn
    parentColumns(0) = DataSet1.Tables( _
        "Customers").Columns("CustID")
    parentColumns(1) = DataSet1.Tables( _
        "Customers").Columns("OrdID")

    childColumns(0) = DataSet1.Tables( _
        "Orders").Columns("CustID")
    childColumns(1) = DataSet1.Tables( _
        "Orders").Columns("OrdID")

    ' Create DataRelation. 
    Dim CustOrderRel As DataRelation = New DataRelation( _
        "CustomersOrders", parentColumns, childColumns)

    ' Add the relation to the DataSet.
    DataSet1.Relations.Add(CustOrderRel)
End Sub

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0
Show:
© 2015 Microsoft