DataRelationCollection.AddRange メソッド

.NET Framework クラス ライブラリ リファレンス

DataRelationCollection.AddRange メソッド

指定した DataRelation 配列の要素をコレクションの末尾にコピーします。

名前空間: System.Data
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Overridable Sub AddRange
 ( _
    relations As DataRelation() _
)

Visual Basic (使用法)

Dim instance As DataRelationCollection
Dim relations As DataRelation()

instance.AddRange(relations)

C#

public virtual void AddRange (
    DataRelation[] relations
)

C++

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

J#

public void AddRange (
    DataRelation[] relations
)

JScript

public function AddRange (
    relations : DataRelation[]
)

パラメータ

relations

コレクションに追加する DataRelation オブジェクトの配列。

解説

BeginInit が呼び出された場合は、EndInit が呼び出されるまで AddRange はコレクションにオブジェクトを追加しません。EndInit が呼び出されると、AddRange への最新の呼び出しで指定された項目がコレクションに追加されます。BeginInit / EndInit シーケンス内で AddRange が複数回呼び出された場合は、AddRange への最新の呼び出しで指定された項目だけが追加されます。

使用例

Visual Basic

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

C#

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 名前空間
その他の技術情報
テーブル間のリレーションシップの追加
テーブル間のリレーションシップの移動