ConstraintCollection.AddRange メソッド

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

C#

public void AddRange (
    Constraint[] constraints
)

C++

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

J#

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

C#

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

プラットフォーム

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

参照

関連項目
ConstraintCollection クラス
ConstraintCollection メンバ
System.Data 名前空間