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)

來源:

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 引數為 Null 值。

ArgumentException

關聯永遠屬於這個集合，或屬於另一個集合。

DuplicateNameException

集合已經和指定名稱產生關聯 (名稱比較不區分大小寫)。

InvalidConstraintException

關聯從一建立以來就進入無效的狀態。

備註

如果成功將關聯新增至集合，就會 CollectionChanged 發生此事件。

DataRelation當物件加入至集合時，如果UniqueConstraint物件不存在，ForeignKeyConstraint則預設會建立 物件。

另請參閱

• 加入 DataRelation
• 導覽 DataRelation

Add(DataColumn, DataColumn)

來源:

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當物件加入至集合時，如果UniqueConstraint物件不存在，ForeignKeyConstraint則預設會建立 物件。

另請參閱

• 加入 DataRelation
• 導覽 DataRelation

Add(DataColumn[], DataColumn[])

來源:

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 引數為 Null 值。

ArgumentException

關聯永遠屬於這個集合，或屬於另一個集合。

DuplicateNameException

集合已經和相同名稱產生關聯 (名稱比較不區分大小寫)。

InvalidConstraintException

關聯從一建立以來就進入無效的狀態。

備註

DataRelation當物件加入至集合時，如果UniqueConstraint物件不存在，ForeignKeyConstraint則預設會建立 物件。

另請參閱

• 加入 DataRelation
• 導覽 DataRelation

Add(String, DataColumn, DataColumn)

來源:

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當物件加入至集合時，如果UniqueConstraint物件不存在，ForeignKeyConstraint則預設會建立 物件。

另請參閱

• 加入 DataRelation
• 導覽 DataRelation

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

來源:

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

關聯名稱為 Null 值。

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當物件加入至集合時，如果UniqueConstraint物件不存在，ForeignKeyConstraint則預設會建立 物件。

另請參閱

• 加入 DataRelation
• 導覽 DataRelation

Add(String, DataColumn, DataColumn, Boolean)

來源:

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當物件加入至集合時，如果UniqueConstraint物件不存在，ForeignKeyConstraint則預設會建立 物件。 若要避免這種情況，您可以將 設定 createConstraints 為 false。

另請參閱

• 加入 DataRelation
• 導覽 DataRelation

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

來源:

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

關聯名稱為 Null 值。

ArgumentException

關聯永遠屬於這個集合，或屬於另一個集合。

DuplicateNameException

集合已經和相同名稱產生關聯 (名稱比較不區分大小寫)。

InvalidConstraintException

關聯從一建立以來就進入無效的狀態。

備註

DataRelation當物件加入至集合時，如果UniqueConstraint物件不存在，ForeignKeyConstraint則預設會建立 物件。

另請參閱

• 加入 DataRelation
• 導覽 DataRelation