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

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

索引トップ用語の索引ランキング

ConstraintCollection.AddRange メソッド

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

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

Visual Basic (宣言)

Public Sub AddRange ( _
    constraints As Constraint() _
)

Visual Basic (使用法)

Dim instance As ConstraintCollection
Dim constraints As Constraint()

instance.AddRange(constraints)

public void AddRange (
    Constraint[] constraints
)

C++

public:
void AddRange (
    array<Constraint^>^ constraints
)

public void AddRange (
    Constraint[] constraints
)

JScript

public function AddRange (
    constraints : Constraint[]
)

パラメータ

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

解説

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

使用例

プライマリキー制約と外部キー制約を作成し、その制約を ConstraintCollection に追加する例を次に示します。

Visual Basic

Public Shared Sub ConstraintAddRange(dataSet
 As DataSet)
    Try
        ' Reference the tables from the DataSet.
        Dim customersTable As DataTable = dataSet.Tables("Customers")
        Dim ordersTable As DataTable = dataSet.Tables("Orders")

        ' Create unique and foreign key constraints.
        Dim uniqueConstraint As UniqueConstraint
 = New _
            UniqueConstraint(customersTable.Columns("CustomerID"))
        Dim fkConstraint As ForeignKeyConstraint
 = New _
            ForeignKeyConstraint("CustOrdersConstraint",
 _
            customersTable.Columns("CustomerID"),
 _
            ordersTable.Columns("CustomerID"))

        ' Add the constraints.
        customersTable.Constraints.AddRange(New Constraint() _
            {uniqueConstraint, fkConstraint})

    Catch ex As Exception
        ' Process exception and return.
        Console.WriteLine("Exception of type {0} occurred.",
 _
        ex.GetType().ToString())
    End Try
End Sub

public static void ConstraintAddRange(DataSet
 dataSet)
{
    try
    {
        // Reference the tables from the DataSet.
        DataTable customersTable = dataSet.Tables["Customers"];
        DataTable ordersTable = dataSet.Tables["Orders"];

        // Create unique and foreign key constraints.
        UniqueConstraint uniqueConstraint = new 
            UniqueConstraint(customersTable.Columns["CustomerID"]);
        ForeignKeyConstraint fkConstraint = new 
            ForeignKeyConstraint("CustOrdersConstraint",
            customersTable.Columns["CustomerID"],
            ordersTable.Columns["CustomerID"]);

        // Add the constraints.
        customersTable.Constraints.AddRange(new Constraint[] 
            {uniqueConstraint, fkConstraint});
    }
    catch(Exception ex)
    {
        // Process exception and return.
        Console.WriteLine("Exception of type {0} occurred.", 
            ex.GetType());
    }
}