ConstraintCollection.Add Metoda

Definice

Obor názvů:

System.Data

Sestavení:

System.Data.Common.dll

Constraint Přidá objekt do kolekce.

Přetížení

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.

Add(Constraint)

Zdroj:

ConstraintCollection.cs

Přidá zadaný Constraint objekt do kolekce.

public:
 void Add(System::Data::Constraint ^ constraint);

public void Add (System.Data.Constraint constraint);

member this.Add : System.Data.Constraint -> unit

Public Sub Add (constraint As Constraint)

Parametry

constraint

Constraint

Příkaz Constraint , který chcete přidat.

Výjimky

ArgumentNullException

Argument constraint má hodnotu null.

ArgumentException

Omezení již patří do této kolekce nebo patří do jiné kolekce.

DuplicateNameException

Kolekce už má omezení se stejným názvem. (Při porovnávání se nerozlišují malá a velká písmena.)

Příklady

Následující příklad přidá UniqueConstraint do ConstraintCollection souboru DataTable.

private void AddConstraint(DataTable table)
{
    UniqueConstraint uniqueConstraint;
    // Assuming a column named "UniqueColumn" exists, and
    // its Unique property is true.
    uniqueConstraint = new UniqueConstraint(
        table.Columns["UniqueColumn"]);
    table.Constraints.Add(uniqueConstraint);
}

Private Sub AddConstraint(table As DataTable)
    Dim uniqueConstraint As UniqueConstraint
    ' Assuming a column named "UniqueColumn" exists, and 
    ' its Unique property is true.
    uniqueConstraint = _
       New UniqueConstraint(table.Columns("UniqueColumn"))
    table.Constraints.Add(uniqueConstraint)
End Sub

Poznámky

Pokud se kolekce úspěšně změní přidáním nebo odebráním omezení, dojde k CollectionChanged události.

Viz také

• UniqueConstraint
• ForeignKeyConstraint

Add(String, DataColumn, Boolean)

Zdroj:

ConstraintCollection.cs

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.

public:
 System::Data::Constraint ^ Add(System::String ^ name, System::Data::DataColumn ^ column, bool primaryKey);

public System.Data.Constraint Add (string? name, System.Data.DataColumn column, bool primaryKey);

member this.Add : string * System.Data.DataColumn * bool -> System.Data.Constraint

Public Function Add (name As String, column As DataColumn, primaryKey As Boolean) As Constraint

Parametry

name

String

Název procesu UniqueConstraint.

column

DataColumn

Hodnota DataColumn , na kterou se omezení vztahuje.

primaryKey

Boolean

Určuje, jestli má být sloupec primárním klíčem. Pokud true, bude sloupec primárním klíčem.

Návraty

Constraint

Nový UniqueConstraint.

Výjimky

ArgumentException

Omezení již patří do této kolekce.

- nebo -

Omezení patří do jiné kolekce.

DuplicateNameException

Kolekce už má omezení se zadaným názvem. (Při porovnávání se nerozlišují malá a velká písmena.)

Příklady

Následující příklad používá metodu Add k vytvoření a přidání nového UniqueConstraint do objektu ConstraintCollection.

private void AddUniqueConstraint(DataTable table){
   table.Constraints.Add("idConstraint", table.Columns["id"], true);
}

Private Sub AddUniqueConstraint(table As DataTable)
    table.Constraints.Add("idConstraint", table.Columns("id"), True)
End Sub

Poznámky

K CollectionChanged události dojde, pokud je omezení úspěšně přidáno.

Viz také

• UniqueConstraint

Add(String, DataColumn, DataColumn)

Zdroj:

ConstraintCollection.cs

Vytvoří nový ForeignKeyConstraint se zadaným názvem, nadřazeným sloupcem a podřízeným sloupcem a přidá omezení do kolekce.

public:
 System::Data::Constraint ^ Add(System::String ^ name, System::Data::DataColumn ^ primaryKeyColumn, System::Data::DataColumn ^ foreignKeyColumn);

public System.Data.Constraint Add (string? name, System.Data.DataColumn primaryKeyColumn, System.Data.DataColumn foreignKeyColumn);

member this.Add : string * System.Data.DataColumn * System.Data.DataColumn -> System.Data.Constraint

Public Function Add (name As String, primaryKeyColumn As DataColumn, foreignKeyColumn As DataColumn) As Constraint

Parametry

name

String

Název procesu ForeignKeyConstraint.

primaryKeyColumn

DataColumn

Primární klíč neboli nadřazený klíč DataColumn.

foreignKeyColumn

DataColumn

Cizí klíč neboli podřízený DataColumnklíč .

Návraty

Constraint

Nový ForeignKeyConstraint.

Příklady

Následující příklad přidá nový ForeignKeyConstraint do ConstraintCollection souboru DataTable.

private void AddForeignConstraint(DataSet dataSet)
{
    try
    {
        DataColumn parentColumn =
            dataSet.Tables["Suppliers"].Columns["SupplierID"];
        DataColumn childColumn =
            dataSet.Tables["Products"].Columns["SupplierID"];
        dataSet.Tables["Products"].Constraints.Add
            ("ProductsSuppliers", parentColumn, childColumn);
    }
    catch(Exception ex)
    {
        // In case the constraint already exists,
        // catch the collision here and respond.
        Console.WriteLine("Exception of type {0} occurred.",
            ex.GetType());
    }
}

Private Sub AddForeignConstraint(dataSet As DataSet)
    Try
        Dim parentColumn As DataColumn = _
            dataSet.Tables("Suppliers").Columns("SupplierID")
        Dim childColumn As DataColumn = _
            dataSet.Tables("Products").Columns("SupplierID")
        dataSet.Tables("Products").Constraints.Add _
            ("ProductsSuppliers", parentColumn, childColumn)
        
    Catch ex As Exception
        ' In case the constraint already exists, 
        ' catch the collision here and respond.
        Console.WriteLine("Exception of type {0} occurred.", _
            ex.GetType().ToString())
    End Try
End Sub

Poznámky

K CollectionChanged události dojde, pokud je omezení úspěšně přidáno.

Add(String, DataColumn[], Boolean)

Zdroj:

ConstraintCollection.cs

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.

public:
 System::Data::Constraint ^ Add(System::String ^ name, cli::array <System::Data::DataColumn ^> ^ columns, bool primaryKey);

public System.Data.Constraint Add (string? name, System.Data.DataColumn[] columns, bool primaryKey);

member this.Add : string * System.Data.DataColumn[] * bool -> System.Data.Constraint

Public Function Add (name As String, columns As DataColumn(), primaryKey As Boolean) As Constraint

Parametry

name

String

Název procesu UniqueConstraint.

columns

DataColumn[]

Pole DataColumn objektů, na které se vztahuje omezení.

primaryKey

Boolean

Určuje, jestli má být sloupec primárním klíčem. Pokud true, bude sloupec primárním klíčem.

Návraty

Constraint

Nový UniqueConstraint.

Výjimky

ArgumentException

Omezení již patří do této kolekce.

- nebo -

Omezení patří do jiné kolekce.

DuplicateNameException

Kolekce už má omezení se zadaným názvem. (Při porovnávání se nerozlišují malá a velká písmena.)

Příklady

Následující příklad vytvoří pole DataColumn objektů, které se používají k vytvoření nového UniqueConstraint v konkrétním DataTableobjektu .

private void AddUniqueConstraint(DataTable table)
{
    DataColumn[] columns = new DataColumn[1];
    columns[0] = table.Columns["ID"];
    columns[1] = table.Columns["Name"];
    table.Constraints.Add("idNameConstraint", columns, true);
}

Private Sub AddUniqueConstraint(table As DataTable)
    Dim columns(1) As DataColumn
    columns(0) = table.Columns("ID")
    columns(1) = table.Columns("Name")
    table.Constraints.Add("idNameConstraint", columns, True)
End Sub

Poznámky

K CollectionChanged události dojde, pokud je omezení úspěšně přidáno.

Viz také

• UniqueConstraint

Add(String, DataColumn[], DataColumn[])

Zdroj:

ConstraintCollection.cs

Vytvoří nový ForeignKeyConstraintobjekt se zadanými poli nadřazených a podřízených sloupců a přidá omezení do kolekce.

public:
 System::Data::Constraint ^ Add(System::String ^ name, cli::array <System::Data::DataColumn ^> ^ primaryKeyColumns, cli::array <System::Data::DataColumn ^> ^ foreignKeyColumns);

public System.Data.Constraint Add (string? name, System.Data.DataColumn[] primaryKeyColumns, System.Data.DataColumn[] foreignKeyColumns);

member this.Add : string * System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.Constraint

Public Function Add (name As String, primaryKeyColumns As DataColumn(), foreignKeyColumns As DataColumn()) As Constraint

Parametry

name

String

Název procesu ForeignKeyConstraint.

primaryKeyColumns

DataColumn[]

Pole DataColumn objektů, které jsou primárním klíčem nebo nadřazeným sloupcem.

foreignKeyColumns

DataColumn[]

Pole DataColumn objektů, které jsou cizími klíči nebo podřízenými sloupci.

Návraty

Constraint

Nový ForeignKeyConstraint.

Příklady

Následující příklad vytvoří dvě pole DataColumn objektů a pak vytvoří dvě ForeignKeyConstraint relace mezi dvěma tabulkami v datové sadě.

private void AddForeignConstraint(
    DataSet dataSet, DataTable table)
{
    try
    {
        DataColumn[] parentColumns = new DataColumn[2];
        DataColumn[] childColumns = new DataColumn[2];
        // Get the tables from the DataSet.
        DataTable customersTable = dataSet.Tables["Customers"];
        DataTable ordersTable = dataSet.Tables["Orders"];

        // Set Columns.
        parentColumns[0]=customersTable.Columns["id"];
        parentColumns[1]=customersTable.Columns["Name"];
        childColumns[0] = ordersTable.Columns["CustomerID"];
        childColumns[1] = ordersTable.Columns["CustomerName"];

        // Create ForeignKeyConstraint
        table.Constraints.Add("CustOrdersConstraint",
            parentColumns, childColumns);
    }
    catch(Exception ex)
    {
        // In case the constraint already exists,
        // catch the collision here and respond.
        Console.WriteLine("Exception of type {0} occurred.",
            ex.GetType());
    }
}

Private Sub AddForeignConstraint( _
ByVal dataSet As DataSet, ByVal table As DataTable)
    Try
        Dim parentColumns(1) As DataColumn
        Dim childColumns(1) As DataColumn
        ' Get the tables from the DataSet.
        Dim customersTable As DataTable = _
            dataSet.Tables("Customers")
        Dim ordersTable As DataTable = _
            dataSet.Tables("Orders")

        ' Set Columns.
        parentColumns(0) = customersTable.Columns("id")
        parentColumns(1) = customersTable.Columns("Name")
        childColumns(0) = ordersTable.Columns("CustomerID")
        childColumns(1) = ordersTable.Columns("CustomerName")

        ' Create ForeignKeyConstraint
        table.Constraints.Add("CustOrdersConstraint", _
            parentColumns, childColumns)

    Catch ex As Exception
        ' In case the constraint already exists, 
        ' catch the collision here and respond.
        Console.WriteLine("Exception of type {0} occurred.", _
            ex.GetType().ToString())
    End Try
End Sub

Poznámky

K CollectionChanged události dojde, pokud je omezení úspěšně přidáno.