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)

來源:: DataRelationCollection.cs

來源:: DataRelationCollection.cs

來源:: 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則預設會建立物件。

另請參閱

適用於

Add(DataColumn, DataColumn)

來源:: DataRelationCollection.cs

來源:: DataRelationCollection.cs

來源:: 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則預設會建立物件。

另請參閱

適用於

Add(DataColumn[], DataColumn[])

來源:: DataRelationCollection.cs

來源:: DataRelationCollection.cs

來源:: 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則預設會建立物件。

另請參閱

適用於

Add(String, DataColumn, DataColumn)

來源:: DataRelationCollection.cs

來源:: DataRelationCollection.cs

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

另請參閱

適用於

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

來源:: DataRelationCollection.cs

來源:: DataRelationCollection.cs

來源:: 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

關聯名稱為 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則預設會建立物件。

另請參閱

適用於

Add(String, DataColumn, DataColumn, Boolean)

來源:: DataRelationCollection.cs

來源:: DataRelationCollection.cs

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

另請參閱

適用於

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

來源:: DataRelationCollection.cs

來源:: DataRelationCollection.cs

來源:: 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

關聯名稱為 Null 值。

ArgumentException

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

DuplicateNameException

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

InvalidConstraintException

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

備註

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

另請參閱

適用於

共用方式為

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)

參數

傳回

例外狀況

備註

另請參閱

適用於

其他資源