DataRelationCollection::Add Method (String^, array<DataColumn^>^, array<DataColumn^>^)
Creates a DataRelation with the specified name and arrays of parent and child columns, and adds it to the collection.
Assembly: System.Data (in System.Data.dll)
public: virtual DataRelation^ Add( String^ name, array<DataColumn^>^ parentColumns, array<DataColumn^>^ childColumns )
Parameters
- name
-
Type:
System::String^
The name of the DataRelation to create.
- parentColumns
-
Type:
array<System.Data::DataColumn^>^
An array of parent DataColumn objects.
- childColumns
-
Type:
array<System.Data::DataColumn^>^
An array of child DataColumn objects.
| Exception | Condition |
|---|---|
| ArgumentNullException | The relation name is a null value. |
| ArgumentException | The relation already belongs to this collection, or it belongs to another collection. |
| DuplicateNameException | The collection already has a relation with the same name. (The comparison is not case sensitive.) |
| InvalidConstraintException | The relation has entered an invalid state since it was created. |
If the relation is successfully added to the collection, the CollectionChanged event occurs.
When a DataRelation object is added to the collection, ForeignKeyConstraint and UniqueConstraint objects are created by default if they do not already exist.
Available since 1.1