DataRelationCollection.Add 方法

定义

命名空间:

System.Data

程序集:

System.Data.Common.dll

向 DataRelation 中添加一个 DataRelationCollection。

重载

Add(DataRelation)	向 DataRelation 中添加一个 DataRelationCollection。
Add(DataColumn, DataColumn)	用指定的父列和子列创建 DataRelation，并将其添加到集合中。
Add(DataColumn[], DataColumn[])	用指定的父列和子列创建 DataRelation，并将其添加到集合中。
Add(String, DataColumn, DataColumn)	用指定名称以及父列和子列创建 DataRelation，并将其添加到集合。
Add(String, DataColumn[], DataColumn[])	使用父列和子列数组创建一个具有指定名称的 DataRelation，并将其添加到集合中。
Add(String, DataColumn, DataColumn, Boolean)	用指定的名称、父列和子列，以及根据 createConstraints 参数的值而定的可选约束创建 DataRelation，并将其添加到集合中。
Add(String, DataColumn[], DataColumn[], Boolean)	用指定的名称、父列和子列的数组以及指定是否创建约束的值，创建 DataRelation，并将其添加到集合。

Add(DataRelation)

Source:

DataRelationCollection.cs

向 DataRelation 中添加一个 DataRelationCollection。

public:
 void Add(System::Data::DataRelation ^ relation);

public void Add (System.Data.DataRelation relation);

member this.Add : System.Data.DataRelation -> unit

Public Sub Add (relation As DataRelation)

参数

relation

DataRelation

要添加到集合中的 DataRelation。

例外

ArgumentNullException

relation 参数为空值。

ArgumentException

该关系已经属于此集合，或者它属于另一个集合。

DuplicateNameException

集合中已经存在具有指定名称的关系。 （该比较不区分大小写。）

InvalidConstraintException

该关系在创建后进入了无效的状态。

注解

如果成功将关系添加到集合中，则会发生 该 CollectionChanged 事件。

DataRelation将 对象添加到集合时， ForeignKeyConstraintUniqueConstraint默认情况下会创建 对象（如果它们尚不存在）。

另请参阅

• 添加 DataRelation
• 导航 DataRelation

Add(DataColumn, DataColumn)

Source:

DataRelationCollection.cs

用指定的父列和子列创建 DataRelation，并将其添加到集合中。

public:
 virtual System::Data::DataRelation ^ Add(System::Data::DataColumn ^ parentColumn, System::Data::DataColumn ^ childColumn);

public virtual System.Data.DataRelation Add (System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn);

abstract member Add : System.Data.DataColumn * System.Data.DataColumn -> System.Data.DataRelation
override this.Add : System.Data.DataColumn * System.Data.DataColumn -> System.Data.DataRelation

Public Overridable Function Add (parentColumn As DataColumn, childColumn As DataColumn) As DataRelation

参数

parentColumn

DataColumn

该关系的父列。

childColumn

DataColumn

该关系的子列。

返回

DataRelation

创建的关系。

注解

DataRelation将 对象添加到集合时， ForeignKeyConstraintUniqueConstraint默认情况下会创建 对象（如果它们尚不存在）。

另请参阅

• 添加 DataRelation
• 导航 DataRelation

Add(DataColumn[], DataColumn[])

Source:

DataRelationCollection.cs

用指定的父列和子列创建 DataRelation，并将其添加到集合中。

public:
 virtual System::Data::DataRelation ^ Add(cli::array <System::Data::DataColumn ^> ^ parentColumns, cli::array <System::Data::DataColumn ^> ^ childColumns);

public virtual System.Data.DataRelation Add (System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns);

abstract member Add : System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.DataRelation
override this.Add : System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.DataRelation

Public Overridable Function Add (parentColumns As DataColumn(), childColumns As DataColumn()) As DataRelation

参数

parentColumns

DataColumn[]

该关系的父列。

childColumns

DataColumn[]

该关系的子列。

返回

DataRelation

创建的关系。

例外

ArgumentNullException

relation 参数为空值。

ArgumentException

该关系已经属于此集合，或者它属于另一个集合。

DuplicateNameException

集合中已存在同名关系。 （该比较不区分大小写。）

InvalidConstraintException

该关系在创建后进入了无效的状态。

注解

DataRelation将 对象添加到集合时， ForeignKeyConstraintUniqueConstraint默认情况下会创建 对象（如果它们尚不存在）。

另请参阅

• 添加 DataRelation
• 导航 DataRelation

Add(String, DataColumn, DataColumn)

Source:

DataRelationCollection.cs

用指定名称以及父列和子列创建 DataRelation，并将其添加到集合。

public:
 virtual System::Data::DataRelation ^ Add(System::String ^ name, System::Data::DataColumn ^ parentColumn, System::Data::DataColumn ^ childColumn);

public virtual System.Data.DataRelation Add (string? name, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn);

abstract member Add : string * System.Data.DataColumn * System.Data.DataColumn -> System.Data.DataRelation
override this.Add : string * System.Data.DataColumn * System.Data.DataColumn -> System.Data.DataRelation

Public Overridable Function Add (name As String, parentColumn As DataColumn, childColumn As DataColumn) As DataRelation

参数

name

String

关系的名称。

parentColumn

DataColumn

该关系的父列。

childColumn

DataColumn

该关系的子列。

返回

DataRelation

创建的关系。

注解

DataRelation将 对象添加到集合时， ForeignKeyConstraintUniqueConstraint默认情况下会创建 对象（如果它们尚不存在）。

另请参阅

• 添加 DataRelation
• 导航 DataRelation

Add(String, DataColumn[], DataColumn[])

Source:

DataRelationCollection.cs

使用父列和子列数组创建一个具有指定名称的 DataRelation，并将其添加到集合中。

public:
 virtual System::Data::DataRelation ^ Add(System::String ^ name, cli::array <System::Data::DataColumn ^> ^ parentColumns, cli::array <System::Data::DataColumn ^> ^ childColumns);

public virtual System.Data.DataRelation Add (string? name, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns);

abstract member Add : string * System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.DataRelation
override this.Add : string * System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.DataRelation

Public Overridable Function Add (name As String, parentColumns As DataColumn(), childColumns As DataColumn()) As DataRelation

参数

name

String

要创建的 DataRelation 的名称。

parentColumns

DataColumn[]

父级 DataColumn 对象的数组。

childColumns

DataColumn[]

子级 DataColumn 对象的数组。

返回

DataRelation

创建的 DataRelation。

例外

ArgumentNullException

该关系名称为空值。

ArgumentException

该关系已经属于此集合，或者它属于另一个集合。

DuplicateNameException

集合中已存在同名关系。 （该比较不区分大小写。）

InvalidConstraintException

该关系在创建后进入了无效的状态。

示例

private void AddRelation()
{
    DataTable table = new DataTable();
    DataColumn column1 = table.Columns.Add("Column1");
    DataColumn column2 = table.Columns.Add("Column2");
    table.ChildRelations.Add("New Relation", column1, column2);
}

Private Sub AddRelation()
    Dim table As New DataTable()
    Dim column1 As DataColumn = table.Columns.Add("Column1")
    Dim column2 As DataColumn = table.Columns.Add("Column2")
    table.ChildRelations.Add("New Relation", column1, column2)
End Sub

注解

如果成功将关系添加到集合中，则会发生 该 CollectionChanged 事件。

DataRelation将 对象添加到集合时， ForeignKeyConstraintUniqueConstraint默认情况下会创建 对象（如果它们尚不存在）。

另请参阅

• 添加 DataRelation
• 导航 DataRelation

Add(String, DataColumn, DataColumn, Boolean)

Source:

DataRelationCollection.cs

用指定的名称、父列和子列，以及根据 createConstraints 参数的值而定的可选约束创建 DataRelation，并将其添加到集合中。

public:
 virtual System::Data::DataRelation ^ Add(System::String ^ name, System::Data::DataColumn ^ parentColumn, System::Data::DataColumn ^ childColumn, bool createConstraints);

public virtual System.Data.DataRelation Add (string? name, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn, bool createConstraints);

abstract member Add : string * System.Data.DataColumn * System.Data.DataColumn * bool -> System.Data.DataRelation
override this.Add : string * System.Data.DataColumn * System.Data.DataColumn * bool -> System.Data.DataRelation

Public Overridable Function Add (name As String, parentColumn As DataColumn, childColumn As DataColumn, createConstraints As Boolean) As DataRelation

参数

name

String

关系的名称。

parentColumn

DataColumn

该关系的父列。

childColumn

DataColumn

该关系的子列。

createConstraints

Boolean

如果创建约束，则为 true；否则为 false。 （默认值为 true）。

返回

DataRelation

创建的关系。

注解

DataRelation将 对象添加到集合时， ForeignKeyConstraintUniqueConstraint默认情况下会创建 对象（如果它们尚不存在）。 若要防止出现这种情况，可以将 设置为 createConstraints false。

另请参阅

• 添加 DataRelation
• 导航 DataRelation

Add(String, DataColumn[], DataColumn[], Boolean)

Source:

DataRelationCollection.cs

用指定的名称、父列和子列的数组以及指定是否创建约束的值，创建 DataRelation，并将其添加到集合。

public:
 virtual System::Data::DataRelation ^ Add(System::String ^ name, cli::array <System::Data::DataColumn ^> ^ parentColumns, cli::array <System::Data::DataColumn ^> ^ childColumns, bool createConstraints);

public virtual System.Data.DataRelation Add (string? name, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns, bool createConstraints);

abstract member Add : string * System.Data.DataColumn[] * System.Data.DataColumn[] * bool -> System.Data.DataRelation
override this.Add : string * System.Data.DataColumn[] * System.Data.DataColumn[] * bool -> System.Data.DataRelation

Public Overridable Function Add (name As String, parentColumns As DataColumn(), childColumns As DataColumn(), createConstraints As Boolean) As DataRelation

参数

name

String

要创建的 DataRelation 的名称。

parentColumns

DataColumn[]

父级 DataColumn 对象的数组。

childColumns

DataColumn[]

子级 DataColumn 对象的数组。

createConstraints

Boolean

若要创建约束，则为 true；否则为 false。

返回

DataRelation

创建的关系。

例外

ArgumentNullException

该关系名称为空值。

ArgumentException

该关系已经属于此集合，或者它属于另一个集合。

DuplicateNameException

集合中已存在同名关系。 （该比较不区分大小写。）

InvalidConstraintException

该关系在创建后进入了无效的状态。

注解

DataRelation将 对象添加到集合时， ForeignKeyConstraintUniqueConstraint默认情况下会创建 对象（如果它们尚不存在）。

另请参阅

• 添加 DataRelation
• 导航 DataRelation