ConstraintCollection Klas

Definitie

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

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

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

public sealed class ConstraintCollection : System.Data.InternalDataCollectionBase

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

type ConstraintCollection = class
    inherit InternalDataCollectionBase

Public Class ConstraintCollection
Inherits InternalDataCollectionBase

Public NotInheritable Class ConstraintCollection
Inherits InternalDataCollectionBase

Overname

Object

InternalDataCollectionBase

ConstraintCollection

Kenmerken

SerializableAttribute

Voorbeelden

In het eerste voorbeeld wordt een DataTable, en wordt een DataColumn (met de Unique eigenschap ingesteld op true) toegevoegd aan de DataColumnCollection. In het tweede voorbeeld wordt een DataSet, twee DataTable objecten, vier kolommen en een DataRelation. Het aantal beperkingen wordt vervolgens afgedrukt om aan te geven dat een ForeignKeyConstraint en een UniqueConstraint worden gemaakt wanneer een DataRelation wordt toegevoegd aan het DataSet object 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

Opmerkingen

De ConstraintCollection toegang wordt geopend via de DataTable.Constraints accommodatie.

De ConstraintCollection kan zowel UniqueConstraint als ForeignKeyConstraint objecten voor de DataTable. Een UniqueConstraint object zorgt ervoor dat gegevens in een specifieke kolom altijd uniek zijn om de gegevensintegriteit te behouden. Hiermee ForeignKeyConstraint bepaalt u wat er gebeurt in gerelateerde tabellen wanneer gegevens in de DataTable tabellen worden bijgewerkt of verwijderd. Als een rij bijvoorbeeld wordt verwijderd, ForeignKeyConstraint wordt bepaald of de gerelateerde rijen ook worden verwijderd (trapsgewijs) of een andere actie.

De ConstraintCollection methode maakt gebruik van standaardverzamelingsmethoden zoals Add, Clearen Remove. Daarnaast kan de Contains methode worden gebruikt om te zoeken naar het bestaan van een bepaalde beperking in de verzameling.

Een UniqueConstraint wordt gemaakt wanneer een DataColumn met de Unique eigenschap is ingesteld op true wordt toegevoegd aan een DataTable object DataColumnCollection.

Er ForeignKeyConstraint wordt een gemaakt wanneer een DataRelation wordt toegevoegd aan een DataSet object DataRelationCollection.

Veiligheid thread

Dit type is veilig voor leesbewerkingen met meerdere leesbewerkingen. U moet schrijfbewerkingen synchroniseren.

Zie ook

• ForeignKeyConstraint
• UniqueConstraint
• DataRelation