DataRelationCollection.AddRange メソッドとは何？わかりやすく解説 Weblio辞書

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

public virtual void AddRange (
    DataRelation[] relations
)

C++

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

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

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