ConstraintCollection クラス

定義

public ref class ConstraintCollection sealed : System::Data::InternalDataCollectionBase

public ref class ConstraintCollection : System::Data::InternalDataCollectionBase

public sealed class ConstraintCollection : System.Data.InternalDataCollectionBase

[System.Serializable]
public class ConstraintCollection : System.Data.InternalDataCollectionBase

type ConstraintCollection = class
    inherit InternalDataCollectionBase

[<System.Serializable>]
type ConstraintCollection = class
    inherit InternalDataCollectionBase

Public NotInheritable Class ConstraintCollection
Inherits InternalDataCollectionBase

Public Class ConstraintCollection
Inherits InternalDataCollectionBase

継承

Object

InternalDataCollectionBase

ConstraintCollection

属性

SerializableAttribute

例

最初の例では、 をDataTable作成し、 (プロパティを Unique に設定してtrue) を にDataColumnCollection追加DataColumnします。 2 番目の例では、 DataSet、2 つの DataTable オブジェクト、4 つの列、および を作成します DataRelation。 その後、制約の数が出力され、 と UniqueConstraint がオブジェクトの DataRelationCollectionにDataSet追加されたときに DataRelation が作成されることを示しますForeignKeyConstraint。

private void MakeTableWithUniqueConstraint()
{
    DataTable table = new DataTable("table");
    DataColumn column = new DataColumn("UniqueColumn");
    column.Unique=true;
    table.Columns.Add(column);

    // Print count, name, and type.
    Console.WriteLine("Constraints.Count "
        + table.Constraints.Count);
    Console.WriteLine(table.Constraints[0].ConstraintName);
    Console.WriteLine(table.Constraints[0].GetType() );

    // Add a second unique column.
    column = new DataColumn("UniqueColumn2");
    column.Unique=true;
    table.Columns.Add(column);

    // Print info again.
    Console.WriteLine("Constraints.Count "
        + table.Constraints.Count);
    Console.WriteLine(table.Constraints[1].ConstraintName);
    Console.WriteLine(table.Constraints[1].GetType() );
}

private void MakeTableWithForeignConstraint()
{
    // Create a DataSet.
    DataSet dataSet = new DataSet("dataSet");

    // Make two tables.
    DataTable customersTable= new DataTable("Customers");
    DataTable ordersTable = new DataTable("Orders");

    // Create four columns, two for each table.
    DataColumn name = new DataColumn("Name");
    DataColumn id = new DataColumn("ID");
    DataColumn orderId = new DataColumn("OrderID");
    DataColumn cDate = new DataColumn("OrderDate");

    // Add columns to tables.
    customersTable.Columns.Add(name);
    customersTable.Columns.Add(id);
    ordersTable.Columns.Add(orderId);
    ordersTable.Columns.Add(cDate);

    // Add tables to the DataSet.
    dataSet.Tables.Add(customersTable);
    dataSet.Tables.Add(ordersTable);

    // Create a DataRelation for two of the columns.
    DataRelation myRelation = new
        DataRelation("CustomersOrders",id,orderId,true);
    dataSet.Relations.Add(myRelation);

    // Print TableName, Constraints.Count,
    // ConstraintName and Type.
    foreach(DataTable t in dataSet.Tables)
    {
        Console.WriteLine(t.TableName);
        Console.WriteLine("Constraints.Count "
            + t.Constraints.Count);
        Console.WriteLine("ParentRelations.Count "
            + t.ParentRelations.Count);
        Console.WriteLine("ChildRelations.Count "
            + t.ChildRelations.Count);
        foreach(Constraint cstrnt in t.Constraints)
        {
            Console.WriteLine(cstrnt.ConstraintName);
            Console.WriteLine(cstrnt.GetType());
        }
    }
}

Private Sub MakeTableWithUniqueConstraint()

    Dim table As New DataTable("table")
    Dim column As New DataColumn("UniqueColumn")
    column.Unique = True
    table.Columns.Add(column)

    ' Print count, name, and type.
    Console.WriteLine("Constraints.Count " _
       + table.Constraints.Count.ToString())
    Console.WriteLine(table.Constraints(0).ConstraintName)
    Console.WriteLine( _
        table.Constraints(0).GetType().ToString())

    ' Add a second unique column.
    column = New DataColumn("UniqueColumn2")
    column.Unique = True
    table.Columns.Add(column)

    ' Print info again.
    Console.WriteLine("Constraints.Count " _
       + table.Constraints.Count.ToString())
    Console.WriteLine(table.Constraints(1).ConstraintName)
    Console.WriteLine( _
        table.Constraints(1).GetType().ToString())
End Sub

Private Sub MakeTableWithForeignConstraint()

    ' Create a DataSet.
    Dim dataSet As New DataSet("dataSet")

    ' Make two tables.
    Dim customersTable As New DataTable("Customers")
    Dim ordersTable As New DataTable("Orders")

    ' Create four columns, two for each table.
    Dim name As New DataColumn("Name")
    Dim id As New DataColumn("ID")
    Dim orderId As New DataColumn("OrderID")
    Dim orderDate As New DataColumn("OrderDate")
    
    ' Add columns to tables.
    customersTable.Columns.Add(name)
    customersTable.Columns.Add(id)
    ordersTable.Columns.Add(orderId)
    ordersTable.Columns.Add(orderDate)
    
    ' Add tables to the DataSet.
    dataSet.Tables.Add(customersTable)
    dataSet.Tables.Add(ordersTable)

    ' Create a DataRelation for two of the columns.
    Dim myRelation As New DataRelation _
       ("CustomersOrders", id, orderId, True)
    dataSet.Relations.Add(myRelation)

    ' Print TableName, Constraints.Count, 
    ' ConstraintName and Type.
    Dim t As DataTable
    For Each t In  dataSet.Tables
        Console.WriteLine(t.TableName)
        Console.WriteLine("Constraints.Count " _
           + t.Constraints.Count.ToString())
        Console.WriteLine("ParentRelations.Count " _
           + t.ParentRelations.Count.ToString())
        Console.WriteLine("ChildRelations.Count " _
           + t.ChildRelations.Count.ToString())
        Dim cstrnt As Constraint
        For Each cstrnt In  t.Constraints
            Console.WriteLine(cstrnt.ConstraintName)
            Console.WriteLine(cstrnt.GetType())
        Next cstrnt
    Next t
End Sub

注釈

は ConstraintCollection 、 プロパティを介して DataTable.Constraints アクセスされます。

にはConstraintCollection、 の オブジェクトと ForeignKeyConstraint オブジェクトの両方UniqueConstraintをDataTable含めることができます。 オブジェクトは UniqueConstraint 、データの整合性を維持するために、特定の列のデータが常に一意であることを確認します。 は ForeignKeyConstraint 、 のデータが更新または削除されたときに関連テーブルで発生する処理を DataTable 決定します。 たとえば、行が削除された場合、 ForeignKeyConstraint は関連する行も削除されるか (連鎖)、またはその他の一連のアクションが決定されます。

ではConstraintCollection、 などのAddClear標準のコレクション メソッドが使用されますRemove。 さらに、 メソッドを Contains 使用して、コレクション内の特定の制約の存在を検索できます。

UniqueConstraintは、 プロパティが にtrue設定された がDataColumnUniqueオブジェクトの DataColumnCollectionにDataTable追加されるときに作成されます。

ForeignKeyConstraintは、 がオブジェクトの DataRelationCollectionにDataSet追加されるときにDataRelation作成されます。

プロパティ

メソッド

イベント

拡張メソッド

適用対象

スレッド セーフ

この型は、マルチスレッド読み取り操作に対して安全です。 すべての書き込み操作を同期する必要があります。

こちらもご覧ください

• ForeignKeyConstraint
• UniqueConstraint
• DataRelation