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объект и добавляется (со свойством UniqueDataColumn , равным true) в DataColumnCollection. Во втором примере создается DataSetобъект , два DataTable объекта, четыре столбца и DataRelation. Затем выводится число ограничений, чтобы показать, что ForeignKeyConstraintUniqueConstraint и создаются при DataRelation добавлении DataSet в объект DataRelationCollection.

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 содержать объекты UniqueConstraint и ForeignKeyConstraint для DataTable. Объект UniqueConstraint гарантирует, что данные в определенном столбце всегда уникальны для сохранения целостности данных. Определяет ForeignKeyConstraint , что будет происходить в связанных таблицах при обновлении или удалении DataTable данных в . Например, если строка удалена, ForeignKeyConstraint будет определять, будут ли связанные строки также удалены (каскад) или какой-либо другой способ действий.

Использует стандартные ConstraintCollection методы сбора, такие как Add, Clearи Remove. Кроме того, Contains метод можно использовать для поиска существования определенного ограничения в коллекции.

Создается UniqueConstraint при добавлении объекта со свойством DataColumnUnique , для свойства , заданного true значением DataTableDataColumnCollection.

Создается ForeignKeyConstraint при добавлении DataRelation к объекту DataSetDataRelationCollection.

Свойства

Методы

События

Методы расширения

Применяется к

Потокобезопасность

Этот тип безопасен для многопоточных операций чтения. Необходимо синхронизировать все операции записи.

См. также раздел

• ForeignKeyConstraint
• UniqueConstraint
• DataRelation