DataRelationCollection.Add 方法

定義

命名空間:: System.Data

組件:: netstandard.dll, System.Data.Common.dll

組件:: System.Data.Common.dll

組件:: System.Data.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

將 DataRelation 加入至 DataRelationCollection。

多載

名稱	Description
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)	根據 DataRelation 參數的值，建立具有指定名稱、父數據行和子數據行的 `createConstraints`，並將它新增至集合。
Add(String, DataColumn[], DataColumn[], Boolean)	使用指定的名稱、父數據行和子數據行的陣列，以及指定是否建立條件約束的值，並將它加入集合中，建立 DataRelation。

Add(DataRelation)

來源:: DataRelationCollection.cs

來源:: DataRelationCollection.cs

來源:: 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 為空值。

ArgumentException

該關係已屬於此收藏，或屬於另一個收藏。

DuplicateNameException

該集合已經與指定名稱有關聯。（此比較不區分大小寫。）

InvalidConstraintException

該關係自創建以來已進入無效狀態。

備註

若該關係成功加入集合，事件 CollectionChanged 即會發生。

當物件 DataRelation 加入集合時， ForeignKeyConstraint UniqueConstraint 且預設建立物件（如果物件尚未存在）。

另請參閱

適用於

Add(DataColumn, DataColumn)

來源:: DataRelationCollection.cs

來源:: DataRelationCollection.cs

來源:: 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 加入集合時， ForeignKeyConstraint UniqueConstraint 且預設建立物件（如果物件尚未存在）。

另請參閱

適用於

Add(DataColumn[], DataColumn[])

來源:: DataRelationCollection.cs

來源:: DataRelationCollection.cs

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

建立的關係。

例外狀況

ArgumentException

該關係已屬於此收藏，或屬於另一個收藏。

DuplicateNameException

該收藏已有同名的關聯。（此比較不區分大小寫。）

InvalidConstraintException

該關係自創建以來已進入無效狀態。

備註

當物件 DataRelation 加入集合時， ForeignKeyConstraint UniqueConstraint 且預設建立物件（如果物件尚未存在）。

另請參閱

適用於

Add(String, DataColumn, DataColumn)

來源:: DataRelationCollection.cs

來源:: DataRelationCollection.cs

來源:: 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 加入集合時， ForeignKeyConstraint UniqueConstraint 且預設建立物件（如果物件尚未存在）。

另請參閱

適用於

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

來源:: DataRelationCollection.cs

來源:: DataRelationCollection.cs

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

關係名稱為空值。

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)

來源:: DataRelationCollection.cs

來源:: DataRelationCollection.cs

來源:: DataRelationCollection.cs

來源:: DataRelationCollection.cs

來源:: DataRelationCollection.cs

根據 DataRelation 參數的值，建立具有指定名稱、父數據行和子數據行的 createConstraints，並將它新增至集合。

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)

來源:: DataRelationCollection.cs

來源:: DataRelationCollection.cs

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