DataRelationCollection.AddRange メソッド

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

Public Overridable Sub AddRange( _
   ByVal relations() As DataRelation _)
[C#]
public virtual void AddRange(DataRelation[] relations);
[C++]
public: virtual void AddRange(DataRelation* relations[]);
[JScript]
public function AddRange(
   relations : DataRelation[]);

パラメータ

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

解説

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

使用例

 
Public Shared Sub AddRelations(myDataSet As DataSet)

    Dim r1 As DataRelation = New DataRelation("CustomerOrders", _
                                       myDataSet.Tables("Customers").Columns("customerId"), _
                                       myDataSet.Tables("Orders").Columns("customerId"))

    Dim r2 As DataRelation = New DataRelation("OrderDetail", _
                                       myDataSet.Tables("Orders").Columns("orderId"), _
                                       myDataSet.Tables("OrderDetails").Columns("orderId"))

    myDataSet.Relations.AddRange( New DataRelation() {r1, r2})

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


[C#] 
public static void AddRelations(DataSet myDataSet)
{
    DataRelation r1 = new DataRelation("CustomerOrders",
                                       myDataSet.Tables["Customers"].Columns["customerId"],
                                       myDataSet.Tables["Orders"].Columns["customerId"]);

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

    myDataSet.Relations.AddRange( new DataRelation[] {r1, r2});

    // Display names of all relations.
    foreach (DataRelation r in myDataSet.Relations)
      Console.WriteLine(r.RelationName);
}


[C++] 

public:
static void AddRelations(DataSet* myDataSet) {

    DataRelation* r1 = new DataRelation(S"CustomerOrders",
        myDataSet->Tables->Item[S"Customers"]->Columns->Item[S"customerId"],
        myDataSet->Tables->Item[S"Orders"]->Columns->Item[S"customerId"]);

    DataRelation* r2 = new DataRelation(S"OrderDetail",
        myDataSet->Tables->Item[S"Orders"]->Columns->Item[S"orderId"],
        myDataSet->Tables->Item[S"OrderDetails"]->Columns->Item[S"orderId"]);

    DataRelation* relationsArray[] = {r1, r2};
    myDataSet->Relations->AddRange(relationsArray);

    // Display names of all relations:
    System::Collections::IEnumerator* myEnum = myDataSet->Relations->GetEnumerator();
    while (myEnum->MoveNext()) {
        DataRelation* r = __try_cast<DataRelation*>(myEnum->Current);
        Console::WriteLine(r->RelationName);
    }
};

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

DataRelationCollection クラス | DataRelationCollection メンバ | System.Data 名前空間