共用方式為


DataRelation 建構函式

定義

初始化 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

例外狀況

DataColumn 物件的其中之一或兩者包含 null

資料行具有不同的資料型別

-或-

資料表不屬於相同的 DataSet

範例

下列範例會建立新的 DataRelation ,並將其新增至 DataRelationCollectionDataSet

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 物件的陣列。

例外狀況

DataColumn 物件的其中之一或兩者包含 null

DataColumn 物件有不同的資料型別

-或-

陣列的其中之一或兩者不是由相同資料表的不同資料行所組成。

-或-

資料表不屬於相同的 DataSet

範例

下列範例會建立新的 DataRelation ,並將其新增至 DataRelationCollectionDataSet

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

例外狀況

DataColumn 物件的其中之一或兩者包含 null

資料行具有不同的資料型別

-或-

資料表不屬於相同的 DataSet

範例

下列範例會建立新的 DataRelation ,並將其新增至 DataRelationCollectionDataSet


 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

例外狀況

DataColumn 物件的其中之一或兩者都是 null

資料行具有不同的資料型別

-或-

資料表不屬於相同的 DataSet

範例

下列範例會建立新的 DataRelation ,並將其新增至 DataRelationCollectionDataSet

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[]

關聯的父 DataColumnDataTable 物件名稱的陣列。

childColumnNames
String[]

關聯的子 DataColumnDataTable 物件名稱的陣列。

nested
Boolean

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

屬性

備註

使用這個建構函式建立的任何DataRelation對象都必須新增至集合,並在和 EndInit 區塊內BeginInit使用 AddRange 方法。 如果未在和 EndInitNullReferenceException 之間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[]

關聯的父 DataColumnDataTable 物件名稱的陣列。

childColumnNames
String[]

關聯的子 DataColumnDataTable 物件名稱的陣列。

nested
Boolean

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

屬性

備註

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

適用於