DataRelationCollection.Add 方法

参考

定义

命名空间:: System.Data

程序集:: System.Data.Common.dll

程序集:: System.Data.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

向 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

Source:: DataRelationCollection.cs

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将对象添加到集合时， ForeignKeyConstraint UniqueConstraint默认情况下会创建对象（如果它们尚不存在）。

另请参阅

适用于

Add(DataColumn, DataColumn)

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

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将对象添加到集合时， ForeignKeyConstraint UniqueConstraint默认情况下会创建对象（如果它们尚不存在）。

另请参阅

适用于

Add(DataColumn[], DataColumn[])

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

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将对象添加到集合时， ForeignKeyConstraint UniqueConstraint默认情况下会创建对象（如果它们尚不存在）。

另请参阅

适用于

Add(String, DataColumn, DataColumn)

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

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);

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将对象添加到集合时， ForeignKeyConstraint UniqueConstraint默认情况下会创建对象（如果它们尚不存在）。

另请参阅

适用于

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

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

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);

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将对象添加到集合时， ForeignKeyConstraint UniqueConstraint默认情况下会创建对象（如果它们尚不存在）。

另请参阅

适用于

Add(String, DataColumn, DataColumn, Boolean)

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

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);

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将对象添加到集合时， ForeignKeyConstraint UniqueConstraint默认情况下会创建对象（如果它们尚不存在）。若要防止出现这种情况，可以将设置为 createConstraints false。

另请参阅

适用于

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

Source:: DataRelationCollection.cs

Source:: DataRelationCollection.cs

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);

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将对象添加到集合时， ForeignKeyConstraint UniqueConstraint默认情况下会创建对象（如果它们尚不存在）。

另请参阅

适用于

DataRelationCollection.Add 方法

定义

重载

Add(DataRelation)

参数

例外

注解

另请参阅

适用于

Add(DataColumn, DataColumn)

参数

返回

注解

另请参阅

适用于

Add(DataColumn[], DataColumn[])

参数

返回

例外

注解

另请参阅

适用于

Add(String, DataColumn, DataColumn)

参数

返回

注解

另请参阅

适用于

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

参数

返回

例外

示例

注解

另请参阅

适用于

Add(String, DataColumn, DataColumn, Boolean)

参数

返回

注解

另请参阅

适用于

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

参数

返回

例外

注解

另请参阅

适用于

反馈

其他资源