ConstraintCollection Třída

Definice

Obor názvů:

System.Data

Sestavení:

System.Data.Common.dll

Zdroj:

ConstraintCollection.cs

Představuje kolekci omezení pro DataTableobjekt .

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

public sealed class ConstraintCollection : System.Data.InternalDataCollectionBase

type ConstraintCollection = class
    inherit InternalDataCollectionBase

Public NotInheritable Class ConstraintCollection
Inherits InternalDataCollectionBase

Dědičnost

Object

InternalDataCollectionBase

ConstraintCollection

Příklady

První příklad vytvoří DataTablea přidá (s jeho Unique vlastností nastavenou DataColumn na true) do objektu DataColumnCollection. Druhý příklad vytvoří DataSetobjekt , dva DataTable objekty, čtyři sloupce a DataRelation. Počet omezení se pak vytiskne, aby se zobrazilo, že ForeignKeyConstraint se při přidání objektu DataRelation do objektu DataSetDataRelationCollectionvytvoří a a UniqueConstraint .

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

Poznámky

K ConstraintCollection objektu se přistupuje prostřednictvím DataTable.Constraints vlastnosti.

Objekt ConstraintCollection může obsahovat objekty i UniqueConstraintForeignKeyConstraint pro DataTable. Objekt UniqueConstraint zajišťuje, aby data v určitém sloupci byla vždy jedinečná, aby se zachovala integrita dat. Určuje ForeignKeyConstraint , co se stane v souvisejících tabulkách, když se data v souboru DataTable aktualizují nebo odstraní. Pokud je například odstraněn řádek, určí, ForeignKeyConstraint zda jsou odstraněny také související řádky (kaskáda), nebo nějaký jiný postup.

Poznámka

Když do objektu DataRelation přidáte objekt, který vytvoří relaci mezi dvěma tabulkami DataSet, vytvoří se automaticky jak objekt ForeignKeyConstraintUniqueConstraint , tak i . Použije UniqueConstraint se na sloupec primárního klíče v nadřazené DataTabletabulce ConstraintCollectiona omezení se přidá do tabulky . Parametr ForeignKeyConstraint se použije na sloupec primárního klíče a sloupec cizího klíče a omezení se přidá do podřízené ConstraintCollectiontabulky .

Používá ConstraintCollection standardní metody shromažďování, jako Addjsou , Cleara Remove. Kromě toho lze metodu Contains použít k vyhledání existence konkrétního omezení v kolekci.

Objekt se UniqueConstraint vytvoří, když DataColumn se do objektu DataColumnCollectionpřidá vlastnost s Unique nastavenou DataTable na true .

Objekt ForeignKeyConstraint se vytvoří při DataRelation přidání objektu do objektu DataSetDataRelationCollection.

Vlastnosti

Count	Získá celkový počet prvků v kolekci. (Zděděno od InternalDataCollectionBase)
IsReadOnly	Získá hodnotu, která označuje, zda InternalDataCollectionBase je jen pro čtení. (Zděděno od InternalDataCollectionBase)
IsSynchronized	Získá hodnotu, která označuje, zda InternalDataCollectionBase je synchronizován. (Zděděno od InternalDataCollectionBase)
Item[Int32]	Constraint Získá z kolekce v zadaném indexu.
Item[String]	Constraint Získá z kolekce se zadaným názvem.
List	Získá položky kolekce jako seznam. (Zděděno od InternalDataCollectionBase)
SyncRoot	Získá objekt, který lze použít k synchronizaci kolekce. (Zděděno od InternalDataCollectionBase)

Metody

Add(Constraint)	Přidá zadaný Constraint objekt do kolekce.
Add(String, DataColumn, Boolean)	Vytvoří nový UniqueConstraint se zadaným názvem , a hodnotou, která označuje, DataColumnzda je sloupec primárním klíčem, a přidá ho do kolekce.
Add(String, DataColumn, DataColumn)	Vytvoří nový ForeignKeyConstraint se zadaným názvem, nadřazeným sloupcem a podřízeným sloupcem a přidá omezení do kolekce.
Add(String, DataColumn[], Boolean)	Vytvoří nový UniqueConstraint se zadaným názvem, polem DataColumn objektů a hodnotou, která označuje, zda je sloupec primárním klíčem, a přidá ho do kolekce.
Add(String, DataColumn[], DataColumn[])	Vytvoří nový ForeignKeyConstraintobjekt se zadanými poli nadřazených a podřízených sloupců a přidá omezení do kolekce.
AddRange(Constraint[])	Zkopíruje prvky zadaného ConstraintCollection pole na konec kolekce.
CanRemove(Constraint)	Určuje, jestli Constraint lze objekt odebrat.
Clear()	Vymaže kolekci všech Constraint objektů.
Contains(String)	Určuje, zda Constraint objekt zadaný názvem existuje v kolekci.
CopyTo(Array, Int32)	Zkopíruje všechny prvky proudu InternalDataCollectionBase do jednorozměrného Array, počínaje zadaným InternalDataCollectionBase indexem. (Zděděno od InternalDataCollectionBase)
CopyTo(Constraint[], Int32)	Zkopíruje objekty kolekce do jednorozměrné Array instance počínaje zadaným indexem.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetEnumerator()	Získá objekt IEnumerator pro kolekci. (Zděděno od InternalDataCollectionBase)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
IndexOf(Constraint)	Získá index zadaného Constraintobjektu .
IndexOf(String)	Získá index zadaného Constraint názvem.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
Remove(Constraint)	Odebere zadaný Constraint objekt z kolekce.
Remove(String)	Odebere Constraint objekt zadaný názvem z kolekce.
RemoveAt(Int32)	Odebere Constraint objekt v zadaném indexu z kolekce.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Událost

CollectionChanged

Nastane při každé ConstraintCollection změně z Constraint důvodu přidání nebo odebrání objektů.

Metody rozšíření

Cast<TResult>(IEnumerable)	Přetypuje prvky objektu na IEnumerable zadaný typ.
OfType<TResult>(IEnumerable)	Filtruje prvky objektu IEnumerable na základě zadaného typu.
AsParallel(IEnumerable)	Umožňuje paralelizaci dotazu.
AsQueryable(IEnumerable)	Převede objekt na IEnumerableIQueryable.

Bezpečný přístup z více vláken

Tento typ je bezpečný pro operace čtení ve více vláknech. Je nutné synchronizovat všechny operace zápisu.

Viz také

• ForeignKeyConstraint
• UniqueConstraint
• DataRelation