DataRelationCollection.AddRange 方法

将指定的 DataRelation 数组的元素复制到集合末尾。

**命名空间:**System.Data
**程序集:**System.Data（在 system.data.dll 中）

语法

声明
Public Overridable Sub AddRange ( _
    relations As DataRelation() _
)
用法
Dim instance As DataRelationCollection
Dim relations As DataRelation()

instance.AddRange(relations)

public virtual void AddRange (
    DataRelation[] relations
)

public:
virtual void AddRange (
    array<DataRelation^>^ relations
)

public void AddRange (
    DataRelation[] relations
)

public function AddRange (
    relations : DataRelation[]
)

参数

• relations
  要添加到集合中的 DataRelation 对象的数组。

备注

如果已经调用 BeginInit，则在调用 EndInit 之前，AddRange 将不会向集合添加任何对象。当调用 EndInit 时，将使用在最近一次对 AddRange 的调用中指定的项填充集合。如果在 BeginInit / EndInit 序列中多次调用了 AddRange，则只添加在最近一次对 AddRange 的调用中指定的那些项。

示例

Public Shared Sub AddRelations(dataSet As DataSet)
    Dim customerOrders As DataRelation = _
        New DataRelation("CustomerOrders", _
        dataSet.Tables("Customers").Columns("customerId"), _
        dataSet.Tables("Orders").Columns("customerId"))
    Dim orderDetails As DataRelation = _
        New DataRelation("OrderDetail", _
        dataSet.Tables("Orders").Columns("orderId"), _
        dataSet.Tables("OrderDetails").Columns("orderId"))

    dataSet.Relations.AddRange(New DataRelation() _
        {customerOrders, orderDetails})

    ' Display names of all relations.
    Dim relation As DataRelation
    For Each relation In dataSet.Relations
      Console.WriteLine(relation.RelationName.ToString())
    Next
End Sub

public static void AddRelations(DataSet dataSet)
{
    DataRelation customerOrders = 
        new DataRelation("CustomerOrders",
        dataSet.Tables["Customers"].Columns["customerId"],
        dataSet.Tables["Orders"].Columns["customerId"]);

    DataRelation orderDetails = 
        new DataRelation("OrderDetail",
        dataSet.Tables["Orders"].Columns["orderId"],
        dataSet.Tables["OrderDetails"].Columns["orderId"]);

    dataSet.Relations.AddRange(new DataRelation[] 
        {customerOrders, orderDetails});

    // Display names of all relations.
    foreach (DataRelation relation in dataSet.Relations)
        Console.WriteLine(relation.RelationName.ToString());
}

平台

Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1、1.0

.NET Compact Framework

受以下版本支持：2.0、1.0

请参见

参考

DataRelationCollection 类
DataRelationCollection 成员
System.Data 命名空间

其他资源

添加表间关系
浏览表间关系