NGWS SDK Documentation  

This is preliminary documentation and subject to change.
To comment on this topic, please send us email at ngwssdk@microsoft.com. Thanks!

DataRelation Constructor

Initializes a new instance of the DataRelation class.

Overload List

Initializes a new instance of the DataRelation class using the specified name, parent, and child columns.

[Visual Basic] Overloads Public Sub New(String, DataColumn, DataColumn)
[C#] public DataRelation(String, DataColumn, DataColumn);
[C++] public: DataRelation(String*, DataColumn, DataColumn);
[JScript] public function DataRelation(String, DataColumn, DataColumn);

Initializes a new instance of the DataRelation class using the specified name, parent, and child columns, and value to create constraints.

[Visual Basic] Overloads Public Sub New(String, DataColumn, DataColumn, Boolean)
[C#] public DataRelation(String, DataColumn, DataColumn, bool);
[C++] public: DataRelation(String*, DataColumn, DataColumn, bool);
[JScript] public function DataRelation(String, DataColumn, DataColumn, Boolean);

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

[Visual Basic] Overloads Public Sub New(String, DataColumn(), DataColumn())
[C#] public DataRelation(String, DataColumn[], DataColumn[]);
[C++] public: DataRelation(String*, DataColumn[], DataColumn[]);
[JScript] public function DataRelation(String, DataColumn[], DataColumn[]);

Initializes a new instance of the DataRelation class using the specified name, matched arrays of parent and child columns, and value to create constraints.

[Visual Basic] Overloads Public Sub New(String, DataColumn(), DataColumn(), Boolean)
[C#] public DataRelation(String, DataColumn[], DataColumn[], bool);
[C++] public: DataRelation(String*, DataColumn[], DataColumn[], bool);
[JScript] public function DataRelation(String, DataColumn[], DataColumn[], Boolean);

Example [Visual Basic]

The following example creates a new DataRelation and adds it to a DataSet object's RelationsCollection.

Note   This example shows how to use one of the overloaded version of the DataRelation constructor. For other examples that may be available, see the individual overload topics.

[Visual Basic]

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

   Set childCols(0) = DataSet1.Tables("Orders").Columns("CustID")
   Set childCols(1) = DataSet1.Tables("Orders").Columns("OrdID")

   Dim bConstraints As Boolean
   bConstraints = True
   ' Create DataRelation.
   Dim relCustOrder As DataRelation
   Set CustOrderRel = New DataRelation("CustomersOrders", parentCols, childCols, bConstraints)
   ' Add the relation to the DataSet.
   DataSet1.Relations.Add(CustOrderRel)
End Sub

See Also

DataRelation Class | DataRelation Members | System.Data Namespace