DataRelation 建構函式

定義

命名空間:: System.Data

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

組件:: System.Data.Common.dll

組件:: System.Data.dll

組件:: netstandard.dll

重要

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

初始化 DataRelation 類別的新執行個體。

多載

名稱	Description
DataRelation(String, DataColumn, DataColumn)	使用指定的DataRelation名稱、父物件和子DataRelation物件初始化該類別的新DataColumn實例。
DataRelation(String, DataColumn[], DataColumn[])	使用指定的DataRelation名稱及匹配的父與子DataRelation物件陣列初始化該類別的新DataColumn實例。
DataRelation(String, DataColumn, DataColumn, Boolean)	使用指定的名稱、父物件與子DataRelation物件，以及指示是否建立約束的值，初始化該類別的新DataColumn實例。
DataRelation(String, DataColumn[], DataColumn[], Boolean)	使用指定的名稱、匹配的父與子DataRelation物件陣列，以及指示是否建立限制的值，初始化該類別的新DataColumn實例。
DataRelation(String, String, String, String[], String[], Boolean)	此建構器用於 Visual Studio 環境中的設計時支援。
DataRelation(String, String, String, String, String, String[], String[], Boolean)	此建構器用於 Visual Studio 環境中的設計時支援。

DataRelation(String, DataColumn, DataColumn)

來源:: DataRelation.cs

來源:: DataRelation.cs

來源:: DataRelation.cs

來源:: DataRelation.cs

來源:: DataRelation.cs

使用指定的DataRelation名稱、父物件和子DataRelation物件初始化該類別的新DataColumn實例。

public:
 DataRelation(System::String ^ relationName, System::Data::DataColumn ^ parentColumn, System::Data::DataColumn ^ childColumn);

public DataRelation(string? relationName, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn);

public DataRelation(string relationName, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn);

new System.Data.DataRelation : string * System.Data.DataColumn * System.Data.DataColumn -> System.Data.DataRelation

Public Sub New (relationName As String, parentColumn As DataColumn, childColumn As DataColumn)

參數

relationName: String

這個名稱 DataRelation。若 null 或為空字串（“”），當所建立物件加入 DataRelationCollection時，會給出預設名稱。

parentColumn: DataColumn

關係中的父母 DataColumn 。

childColumn: DataColumn

關係中的孩子 DataColumn 。

例外狀況

ArgumentNullException

其中一個或兩個 DataColumn 物件包含 null。

InvalidConstraintException

欄位有不同的資料型態

- 或者 -

這些表格並不屬於同 DataSet一個。

範例

以下範例建立一個新 DataRelation ，並將其加入 DataRelationCollection 的 DataSet。

private void CreateRelation()
{
    // Code to get the DataSet not shown here.
    // Get the DataColumn objects from two DataTable
    // objects in a DataSet.
    DataColumn[] parentCols = new DataColumn[]
        {DataSet1.Tables["Customers"].Columns["CustID"],
        DataSet1.Tables["Customers"].Columns["OrdID"]};
    DataColumn[] childCols= new DataColumn[]
        {DataSet1.Tables["Orders"].Columns["CustID"],
        DataSet1.Tables["Orders"].Columns["OrdID"]};

    // Create DataRelation.
    DataRelation CustOrderRel = new DataRelation(
        "CustomersOrders", parentCols, childCols);

    // Add the relation to the DataSet.
    DataSet1.Relations.Add(CustOrderRel);
}


 Private Sub CreateRelation()
    ' Code to get the DataSet not shown here.
    ' Get the DataColumn objects from two DataTable 
    ' objects in a DataSet.
    Dim parentCols As DataColumn() = _
        {DataSet1.Tables("Customers").Columns("CustID"), _
        DataSet1.Tables("Customers").Columns("OrdID")}
    Dim childCols As DataColumn() = _
        {DataSet1.Tables("Orders").Columns("CustID"), _
        DataSet1.Tables("Orders").Columns("OrdID")}

    ' Create DataRelation.
    Dim CustOrderRel As New DataRelation( _
        "CustomersOrders", parentCols, childCols)

    ' Add the relation to the DataSet.
    DataSet1.Relations.Add(CustOrderRel)
End Sub

另請參閱

適用於

DataRelation(String, DataColumn[], DataColumn[])

來源:: DataRelation.cs

來源:: DataRelation.cs

來源:: DataRelation.cs

來源:: DataRelation.cs

來源:: DataRelation.cs

使用指定的DataRelation名稱及匹配的父與子DataRelation物件陣列初始化該類別的新DataColumn實例。

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

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

public DataRelation(string relationName, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns);

new System.Data.DataRelation : string * System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.DataRelation

Public Sub New (relationName As String, parentColumns As DataColumn(), childColumns As DataColumn())

參數

relationName: String

那個親戚的名字。若 null 或為空字串（“”），當所建立物件加入 DataRelationCollection時，會給出預設名稱。

parentColumns: DataColumn[]

一組父 DataColumn 物件陣列。

childColumns: DataColumn[]

一組子 DataColumn 物件陣列。

例外狀況

ArgumentNullException

其中一個或兩個 DataColumn 物件包含 null。

InvalidConstraintException

這些 DataColumn 物件有不同的資料型態

- 或者 -

其中一個或兩個陣列並非由同一資料表的不同欄位組成。

- 或者 -

這些表格並不屬於同 DataSet一個。

範例

以下範例建立一個新 DataRelation ，並將其加入 DataRelationCollection 的 DataSet。

Private Sub CreateRelation()
    ' Code to get the DataSet not shown here.
    ' Get the DataColumn objects from two DataTable 
    ' objects in a DataSet.
    Dim parentColumns() As DataColumn
    Dim childColumns() As DataColumn
    parentColumns(0) = DataSet1.Tables( _
        "Customers").Columns("CustID")
    parentColumns(1) = DataSet1.Tables( _
        "Customers").Columns("OrdID")
 
    childColumns(0) = DataSet1.Tables( _
        "Orders").Columns("CustID")
    childColumns(1) = DataSet1.Tables( _
        "Orders").Columns("OrdID")

    ' Create DataRelation.
    Dim CustOrderRel As New DataRelation( _
        "CustomersOrders", parentColumns, childColumns)

    ' Add the relation to the DataSet.
    DataSet1.Relations.Add(CustOrderRel)
End Sub

另請參閱

適用於

DataRelation(String, DataColumn, DataColumn, Boolean)

來源:: DataRelation.cs

來源:: DataRelation.cs

來源:: DataRelation.cs

來源:: DataRelation.cs

來源:: DataRelation.cs

使用指定的名稱、父物件與子DataRelation物件，以及指示是否建立約束的值，初始化該類別的新DataColumn實例。

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

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

public DataRelation(string relationName, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn, bool createConstraints);

new System.Data.DataRelation : string * System.Data.DataColumn * System.Data.DataColumn * bool -> System.Data.DataRelation

Public Sub New (relationName As String, parentColumn As DataColumn, childColumn As DataColumn, createConstraints As Boolean)

參數

relationName: String

那個親戚的名字。若 null 或為空字串（“”），當所建立物件加入 DataRelationCollection時，會給出預設名稱。

parentColumn: DataColumn

親屬中的父母 DataColumn 。

childColumn: DataColumn

關係中的孩子 DataColumn 。

createConstraints: Boolean

一個表示是否建立約束的值。 true，若建立了約束條件。否則為 false。

例外狀況

ArgumentNullException

其中一個或兩個 DataColumn 物件包含 null。

InvalidConstraintException

欄位有不同的資料型態

- 或者 -

這些表格並不屬於同 DataSet一個。

範例

以下範例建立一個新 DataRelation ，並將其加入 DataRelationCollection 的 DataSet。


 Private Sub CreateRelation()
    ' Code to get the DataSet not shown here.
    ' Get the DataColumn objects from two DataTable 
    ' objects in a DataSet.
    Dim parentColumn As DataColumn = DataSet1.Tables( _
        "Customers").Columns("CustID")
    Dim childColumn As DataColumn = _
        DataSet1.Tables("Orders").Columns("CustID")

    ' Create DataRelation.
    Dim bConstraints As Boolean = True
    Dim customerOrdersRelation As DataRelation = _
        New DataRelation("CustomersOrders", _
        parentColumn, childColumn, bConstraints)

    ' Add the relation to the DataSet.
    DataSet1.Relations.Add(customerOrdersRelation)
End Sub

另請參閱

適用於

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

來源:: DataRelation.cs

來源:: DataRelation.cs

來源:: DataRelation.cs

來源:: DataRelation.cs

來源:: DataRelation.cs

使用指定的名稱、匹配的父與子DataRelation物件陣列，以及指示是否建立限制的值，初始化該類別的新DataColumn實例。

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

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

public DataRelation(string relationName, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns, bool createConstraints);

new System.Data.DataRelation : string * System.Data.DataColumn[] * System.Data.DataColumn[] * bool -> System.Data.DataRelation

Public Sub New (relationName As String, parentColumns As DataColumn(), childColumns As DataColumn(), createConstraints As Boolean)

參數

relationName: String

那個親戚的名字。若 null 或為空字串（“”），當所建立物件加入 DataRelationCollection時，會給出預設名稱。

parentColumns: DataColumn[]

一組父 DataColumn 物件陣列。

childColumns: DataColumn[]

一組子 DataColumn 物件陣列。

createConstraints: Boolean

一個表示是否要建立約束的值。 true，若建立了約束條件。否則為 false。

例外狀況

ArgumentNullException

其中一個或兩個 DataColumn 物件為 null。

InvalidConstraintException

欄位有不同的資料型態

- 或者 -

這些表格並不屬於同 DataSet一個。

範例

以下範例建立一個新 DataRelation ，並將其加入 DataRelationCollection 的 DataSet。

Private Sub CreateRelation()
    ' Code to get the DataSet not shown here.
    ' Get the DataColumn objects from two DataTable 
    ' objects in a DataSet.
    Dim parentColumns() As DataColumn
    Dim childColumns() As DataColumn
    parentColumns(0) = DataSet1.Tables( _
        "Customers").Columns("CustID")
    parentColumns(1) = DataSet1.Tables( _
        "Customers").Columns("OrdID")
 
    childColumns(0) = DataSet1.Tables( _
        "Orders").Columns("CustID")
    childColumns(1) = DataSet1.Tables( _
        "Orders").Columns("OrdID")
 
    Dim bConstraints As Boolean = True
    ' Create DataRelation.
    Dim CustOrderRel As New DataRelation( _
        "CustomersOrders", parentColumns, childColumns,  _
        bConstraints)

    ' Add the relation to the DataSet.
    DataSet1.Relations.Add(CustOrderRel)
End Sub

另請參閱

適用於

DataRelation(String, String, String, String[], String[], Boolean)

來源:: DataRelation.cs

來源:: DataRelation.cs

來源:: DataRelation.cs

來源:: DataRelation.cs

來源:: DataRelation.cs

此建構器用於 Visual Studio 環境中的設計時支援。

public:
 DataRelation(System::String ^ relationName, System::String ^ parentTableName, System::String ^ childTableName, cli::array <System::String ^> ^ parentColumnNames, cli::array <System::String ^> ^ childColumnNames, bool nested);

[System.ComponentModel.Browsable(false)]
public DataRelation(string relationName, string? parentTableName, string? childTableName, string[]? parentColumnNames, string[]? childColumnNames, bool nested);

[System.ComponentModel.Browsable(false)]
public DataRelation(string relationName, string parentTableName, string childTableName, string[] parentColumnNames, string[] childColumnNames, bool nested);

[<System.ComponentModel.Browsable(false)>]
new System.Data.DataRelation : string * string * string * string[] * string[] * bool -> System.Data.DataRelation

Public Sub New (relationName As String, parentTableName As String, childTableName As String, parentColumnNames As String(), childColumnNames As String(), nested As Boolean)

參數

relationName: String

那個親戚的名字。若 null 或為空字串（“”），當所建立物件加入 DataRelationCollection時，會給出預設名稱。

parentTableName: String

該關係的父 DataTable 表名稱 that。

childTableName: String

該關係的子表的名稱 DataTable 。

parentColumnNames: String[]

關係父節點中的DataColumn物件名稱陣列DataTable。

childColumnNames: String[]

一個位於關係子節點DataColumn中的物件名稱陣列DataTable。

nested: Boolean

一個表示關係是否巢狀的值。

屬性: BrowsableAttribute

備註

使用此建構子建立的任何DataRelation物件，必須在 a AddRange 和 BeginInit block 內的方法EndInit中加入集合。若未在和 BeginInit EndInit 之間呼叫此建構子，將發生 a NullReferenceException 。此外，指定名稱的表格與欄位必須在構造子被呼叫時存在。

適用於

DataRelation(String, String, String, String, String, String[], String[], Boolean)

來源:: DataRelation.cs

來源:: DataRelation.cs

來源:: DataRelation.cs

來源:: DataRelation.cs

來源:: DataRelation.cs

此建構器用於 Visual Studio 環境中的設計時支援。

public:
 DataRelation(System::String ^ relationName, System::String ^ parentTableName, System::String ^ parentTableNamespace, System::String ^ childTableName, System::String ^ childTableNamespace, cli::array <System::String ^> ^ parentColumnNames, cli::array <System::String ^> ^ childColumnNames, bool nested);

[System.ComponentModel.Browsable(false)]
public DataRelation(string relationName, string? parentTableName, string? parentTableNamespace, string? childTableName, string? childTableNamespace, string[]? parentColumnNames, string[]? childColumnNames, bool nested);

[System.ComponentModel.Browsable(false)]
public DataRelation(string relationName, string parentTableName, string parentTableNamespace, string childTableName, string childTableNamespace, string[] parentColumnNames, string[] childColumnNames, bool nested);

[<System.ComponentModel.Browsable(false)>]
new System.Data.DataRelation : string * string * string * string * string * string[] * string[] * bool -> System.Data.DataRelation

Public Sub New (relationName As String, parentTableName As String, parentTableNamespace As String, childTableName As String, childTableNamespace As String, parentColumnNames As String(), childColumnNames As String(), nested As Boolean)

參數

relationName: String

這個名稱 DataRelation。若 null 或為空字串（“”），當所建立物件加入 DataRelationCollection時，會給出預設名稱。

parentTableName: String

該關係的父 DataTable 表名稱 that。

parentTableNamespace: String

父資料表命名空間的名稱。

childTableName: String

該關係的子表的名稱 DataTable 。

childTableNamespace: String

子資料表命名空間的名稱。

parentColumnNames: String[]

關係父節點中的DataColumn物件名稱陣列DataTable。

childColumnNames: String[]

一個位於關係子節點DataColumn中的物件名稱陣列DataTable。

nested: Boolean

一個表示關係是否巢狀的值。

屬性: BrowsableAttribute

備註

使用此建構子建立的任何DataRelation物件，必須加入集合中。AddRange 指定名稱的表格與欄位必須在呼叫該方法時存在，或者若 BeginInit 在呼叫此建構子之前已被呼叫，則指定名稱的表格與欄位必須在 EndInit 呼叫時存在。

適用於

意見反應

此頁面對您有幫助嗎？