DataRelation 构造函数

定义

命名空间:

System.Data

程序集:

System.Data.Common.dll

初始化 DataRelation 类的新实例。

重载

DataRelation(String, DataColumn, DataColumn)	使用指定的 DataRelation 名称、父级和子级 DataColumn 对象，初始化 DataRelation 类的新实例。
DataRelation(String, DataColumn[], DataColumn[])	使用指定的 DataRelation 名称、父级和子级 DataColumn 对象的匹配数组，初始化 DataRelation 类的新实例。
DataRelation(String, DataColumn, DataColumn, Boolean)	使用指定名称、父级和子级 DataColumn 对象以及指示是否创建约束的值，初始化 DataRelation 类的新实例。
DataRelation(String, DataColumn[], DataColumn[], Boolean)	使用指定的名称、父级和子级 DataColumn 对象的匹配数组以及指示是否创建约束的值，初始化 DataRelation 类的新实例。
DataRelation(String, String, String, String[], String[], Boolean)	此构造函数在 Visual Studio 环境中提供设计时支持。
DataRelation(String, String, String, String, String, String[], String[], Boolean)	此构造函数在 Visual Studio 环境中提供设计时支持。

DataRelation(String, DataColumn, DataColumn)

Source:

DataRelation.cs

使用指定的 DataRelation 名称、父级和子级 DataColumn 对象，初始化 DataRelation 类的新实例。

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);

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

另请参阅

• DataColumn
• RelationName

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

Source:

DataRelation.cs

使用指定的 DataRelation 名称、父级和子级 DataColumn 对象的匹配数组，初始化 DataRelation 类的新实例。

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);

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

另请参阅

• DataColumn
• ForeignKeyConstraint
• RelationName

DataRelation(String, DataColumn, DataColumn, Boolean)

Source:

DataRelation.cs

使用指定名称、父级和子级 DataColumn 对象以及指示是否创建约束的值，初始化 DataRelation 类的新实例。

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);

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

另请参阅

• DataColumn
• ForeignKeyConstraint
• RelationName

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

Source:

DataRelation.cs

使用指定的名称、父级和子级 DataColumn 对象的匹配数组以及指示是否创建约束的值，初始化 DataRelation 类的新实例。

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);

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

另请参阅

• DataColumn
• ForeignKeyConstraint
• RelationName

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

Source:

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

关系的父级 DataTable 中的 DataColumn 对象名称的数组。

childColumnNames

String[]

关系的子级 DataColumn 中的 DataTable 对象名称的数组。

nested

Boolean

一个指示是否嵌套关系的值。

属性

BrowsableAttribute

注解

使用此构造函数创建的任何DataRelation对象都必须使用 AddRange 和 EndInit 块内的 BeginInit 方法添加到集合中。 如果未在 和 EndInit 之间BeginInit调用此构造函数，NullReferenceException将发生 。 此外，调用构造函数时，必须存在具有指定名称的表和列。

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

Source:

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

关系的父级 DataTable 中的 DataColumn 对象名称的数组。

childColumnNames

String[]

关系的子级 DataColumn 中的 DataTable 对象名称的数组。

nested

Boolean

一个指示是否嵌套关系的值。

属性

BrowsableAttribute

注解

然后，使用此构造函数创建的任何 DataRelation 对象都必须通过 添加到集合 AddRange中。 具有指定名称的表和列必须在调用方法时存在，或者如果在 BeginInit 调用此构造函数之前已调用，则具有指定名称的表和列必须在调用时 EndInit 存在。