DataRelationCollection::Add Method (array<DataColumn^>^, array<DataColumn^>^)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Creates a DataRelation with the specified parent and child columns, and adds it to the collection.

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

public:
virtual DataRelation^ Add(
	array<DataColumn^>^ parentColumns,
	array<DataColumn^>^ childColumns
)

Parameters

parentColumns
Type: array<System.Data::DataColumn^>^

The parent columns of the relation.

childColumns
Type: array<System.Data::DataColumn^>^

The child columns of the relation.

Return Value

Type: System.Data::DataRelation^

The created relation.

Exception Condition
ArgumentNullException

The relation argument 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.

When a DataRelation object is added to the collection, ForeignKeyConstraint and UniqueConstraint objects are created by default if they do not already exist.

.NET Framework
Available since 1.1
Return to top
Show: