DataRelation 构造函数

定义

命名空间:: System.Data

程序集:: netstandard.dll, System.Data.Common.dll

程序集:: 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对象以及指示是否创建约束的值初始化类的新实例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)

Source:: DataRelation.cs

Source:: DataRelation.cs

Source:: DataRelation.cs

Source:: DataRelation.cs

Source:: 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 a 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[])

Source:: DataRelation.cs

Source:: DataRelation.cs

Source:: DataRelation.cs

Source:: DataRelation.cs

Source:: 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 a 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)

Source:: DataRelation.cs

Source:: DataRelation.cs

Source:: DataRelation.cs

Source:: DataRelation.cs

Source:: 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

一个值，该值指示是否创建约束。如果创建了约束，则为。否则为 false。

例外

ArgumentNullException

一个或两个 DataColumn 对象都包含 null。

InvalidConstraintException

列具有不同的数据类型

-或者-

这些表不属于同一 DataSet个表。

示例

以下示例创建一个新 DataRelation 项并将其添加到 DataRelationCollection a 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)

Source:: DataRelation.cs

Source:: DataRelation.cs

Source:: DataRelation.cs

Source:: DataRelation.cs

Source:: 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

一个值，该值指示是否创建约束。如果创建了约束，则为。否则为 false。

例外

ArgumentNullException

一 DataColumn 个或两个对象是 null。

InvalidConstraintException

列具有不同的数据类型

-或者-

这些表不属于同一 DataSet个表。

示例

以下示例创建一个新 DataRelation 项并将其添加到 DataRelationCollection a 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)

Source:: DataRelation.cs

Source:: DataRelation.cs

Source:: DataRelation.cs

Source:: DataRelation.cs

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

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

属性: BrowsableAttribute

注解

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

适用于

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

Source:: DataRelation.cs

Source:: DataRelation.cs

Source:: DataRelation.cs

Source:: DataRelation.cs

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

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

属性: BrowsableAttribute

注解

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

适用于

反馈

此页面是否有帮助？