Sdílet prostřednictvím


ConstraintCollection.Add Metoda

Definice

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
Zdroj:
ConstraintCollection.cs
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

Argument constraint má hodnotu null.

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

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é

Platí pro

Add(String, DataColumn, Boolean)

Zdroj:
ConstraintCollection.cs
Zdroj:
ConstraintCollection.cs
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:
 virtual 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);
public System.Data.Constraint Add (string name, System.Data.DataColumn column, bool primaryKey);
public virtual System.Data.Constraint Add (string name, System.Data.DataColumn column, bool primaryKey);
member this.Add : string * System.Data.DataColumn * bool -> System.Data.Constraint
abstract member Add : string * System.Data.DataColumn * bool -> System.Data.Constraint
override this.Add : string * System.Data.DataColumn * bool -> System.Data.Constraint
Public Function Add (name As String, column As DataColumn, primaryKey As Boolean) As Constraint
Public Overridable 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

Nový UniqueConstraint.

Výjimky

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

- nebo -

Omezení patří do jiné kolekce.

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é

Platí pro

Add(String, DataColumn, DataColumn)

Zdroj:
ConstraintCollection.cs
Zdroj:
ConstraintCollection.cs
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:
 virtual 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);
public System.Data.Constraint Add (string name, System.Data.DataColumn primaryKeyColumn, System.Data.DataColumn foreignKeyColumn);
public virtual 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
abstract member Add : string * System.Data.DataColumn * System.Data.DataColumn -> System.Data.Constraint
override 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
Public Overridable 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

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.

Platí pro

Add(String, DataColumn[], Boolean)

Zdroj:
ConstraintCollection.cs
Zdroj:
ConstraintCollection.cs
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:
 virtual 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);
public System.Data.Constraint Add (string name, System.Data.DataColumn[] columns, bool primaryKey);
public virtual System.Data.Constraint Add (string name, System.Data.DataColumn[] columns, bool primaryKey);
member this.Add : string * System.Data.DataColumn[] * bool -> System.Data.Constraint
abstract member Add : string * System.Data.DataColumn[] * bool -> System.Data.Constraint
override this.Add : string * System.Data.DataColumn[] * bool -> System.Data.Constraint
Public Function Add (name As String, columns As DataColumn(), primaryKey As Boolean) As Constraint
Public Overridable 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

Nový UniqueConstraint.

Výjimky

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

- nebo -

Omezení patří do jiné kolekce.

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é

Platí pro

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

Zdroj:
ConstraintCollection.cs
Zdroj:
ConstraintCollection.cs
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:
 virtual 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);
public System.Data.Constraint Add (string name, System.Data.DataColumn[] primaryKeyColumns, System.Data.DataColumn[] foreignKeyColumns);
public virtual 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
abstract member Add : string * System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.Constraint
override 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
Public Overridable 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

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.

Platí pro