ConstraintCollection.AddRange メソッド

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

Public Sub AddRange( _
   ByVal constraints() As Constraint _)
[C#]
public void AddRange(Constraint[] constraints);
[C++]
public: void AddRange(Constraint* constraints[]);
[JScript]
public function AddRange(
   constraints : Constraint[]);

パラメータ

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

解説

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

使用例

[Visual Basic, C#, C++] プライマリ キー制約と外部キー制約を作成し、その制約を ConstraintCollection に追加する例を次に示します。

 
Public Shared Sub ConstraintAddRange(myDataSet As DataSet)
    Try
        ' Reference the tables from the DataSet.
        Dim tCustomers As DataTable = myDataSet.Tables("Customers")
        Dim tOrders As DataTable = myDataSet.Tables("Orders")

        ' Create unique and foreign key constraints.
        Dim uc As UniqueConstraint = New UniqueConstraint(tCustomers.Columns("CustomerID"))
        Dim fk As ForeignKeyConstraint = New ForeignKeyConstraint("CustOrdersConstraint", _
                                                       tCustomers.Columns("CustomerID"), _
                                                       tOrders.Columns("CustomerID"))

        ' Add the constraints.
        tCustomers.Constraints.AddRange(New Constraint() {uc, fk})
    Catch e As Exception
        ' Process exception and return.
                Dim log As System.Diagnostics.EventLog = New System.Diagnostics.EventLog()
                log.Source = "My Application"
                log.WriteEntry(e.ToString())
                Console.WriteLine("Exception of type {0} occurred.", e.GetType().ToString())
    End Try
End Sub

[C#] 
public static void ConstraintAddRange(DataSet myDataSet)
{
    try
    {
        // Reference the tables from the DataSet.
        DataTable tCustomers = myDataSet.Tables["Customers"];
        DataTable tOrders = myDataSet.Tables["Orders"];

        // Create unique and foreign key constraints.
        UniqueConstraint uc = new UniqueConstraint(tCustomers.Columns["CustomerID"]);
        ForeignKeyConstraint fk = new ForeignKeyConstraint("CustOrdersConstraint",
                                                                   tCustomers.Columns["CustomerID"],
                                                                   tOrders.Columns["CustomerID"]);

        // Add the constraints.
        tCustomers.Constraints.AddRange(new Constraint[] {uc, fk});
    }
    catch(Exception e)
    {
        // Process exception and return.
                System.Diagnostics.EventLog log = new System.Diagnostics.EventLog();
                log.Source = "My Application";
                log.WriteEntry(e.ToString());
                Console.WriteLine("Exception of type {0} occurred.", e.GetType());
    }
}

[C++] 
public:
    static void ConstraintAddRange(DataSet* myDataSet)
    {
        try
        {
            // Reference the tables from the DataSet.
            DataTable* tCustomers = myDataSet->Tables->Item[S"Customers"];
            DataTable* tOrders = myDataSet->Tables->Item[S"Orders"];

            // Create unique and foreign key constraints.
            UniqueConstraint* uc = new UniqueConstraint(tCustomers->Columns->Item[S"CustomerID"]);
            ForeignKeyConstraint* fk = new ForeignKeyConstraint(S"CustOrdersConstraint",
                tCustomers->Columns->Item[S"CustomerID"],
                tOrders->Columns->Item[S"CustomerID"]);

            // Add the constraints.
            Constraint* constraintArray[] = {uc, fk};
            tCustomers->Constraints->AddRange(constraintArray);
        }
        catch (Exception* e)
        {
            // Process exception and return.
            System::Diagnostics::EventLog* log = new System::Diagnostics::EventLog();
            log->Source = S"My Application";
            log->WriteEntry(e->ToString());
            Console::WriteLine(S"Exception of type {0} occurred.", e->GetType());
        }
    };

[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

参照

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