DataRelation 建構函式

參考

定義

命名空間:: System.Data

組件:: System.Data.Common.dll

組件:: System.Data.dll

組件:: netstandard.dll

重要

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

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

多載

DataRelation(String, DataColumn, DataColumn)	使用指定的 DataRelation 名稱以及父和子 DataRelation 物件，初始化 DataColumn 類別的新執行個體。
DataRelation(String, DataColumn[], DataColumn[])	使用指定的 DataRelation 名稱以及父和子 DataRelation 物件的相符陣列，初始化 DataColumn 類別的新執行個體。
DataRelation(String, DataColumn, DataColumn, Boolean)	使用指定的名稱、父和子 DataRelation 物件，以及指出是否建立條件約束 (Constraint) 的值，初始化 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 名稱以及父和子 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 名稱以及父和子 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 物件，以及指出是否建立條件約束 (Constraint) 的值，初始化 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 物件的相符陣列，以及指出是否建立條件約束的值，初始化 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

這個建構函式是在 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 之名稱。

childTableName: String

為關聯子資料表的 DataTable 之名稱。

parentColumnNames: String[]

關聯的父 DataColumn 中 DataTable 物件名稱的陣列。

childColumnNames: String[]

關聯的子 DataColumn 中 DataTable 物件名稱的陣列。

nested: Boolean

指出關聯性是否為巢狀 (Nest) 的值。

屬性: BrowsableAttribute

備註

使用這個建構函式建立的任何DataRelation對象都必須新增至集合，並在和 EndInit 區塊內BeginInit使用 AddRange 方法。如果未在和 EndInit NullReferenceException 之間BeginInit呼叫這個建構函式，就會發生。此外，呼叫建構函式時，必須存在具有指定名稱的數據表和數據行。

適用於

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

來源:: 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 之名稱。

parentTableNamespace: String

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

childTableName: String

為關聯子資料表的 DataTable 之名稱。

childTableNamespace: String

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

parentColumnNames: String[]

關聯的父 DataColumn 中 DataTable 物件名稱的陣列。

childColumnNames: String[]

關聯的子 DataColumn 中 DataTable 物件名稱的陣列。

nested: Boolean

指出關聯性是否為巢狀 (Nest) 的值。

屬性: BrowsableAttribute

備註

使用這個建構函式建立的任何 DataRelation 物件都必須使用 AddRange新增至集合。呼叫方法時必須存在具有指定名稱的數據表和數據行，或者如果在 BeginInit 呼叫這個建構函式之前已呼叫，則具有指定名稱的數據表和數據行必須在呼叫時 EndInit 存在。

適用於

共用方式為

DataRelation 建構函式

定義

多載

DataRelation(String, DataColumn, DataColumn)

參數

例外狀況

範例

另請參閱

適用於

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

參數

例外狀況

範例

另請參閱

適用於

DataRelation(String, DataColumn, DataColumn, Boolean)

參數

例外狀況

範例

另請參閱

適用於

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

參數

例外狀況

範例

另請參閱

適用於

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

參數

備註

適用於

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

參數

備註

適用於

其他資源