ConstraintCollection.Add Metoda

Definice

Obor názvů:

System.Data

Sestavení:

netstandard.dll, System.Data.Common.dll

Constraint Přidá objekt do kolekce.

Přetížení

Name	Description
Add(Constraint)	Přidá zadaný Constraint objekt do kolekce.
Add(String, DataColumn, Boolean)	Vytvoří nový UniqueConstraint se zadaným názvem a hodnotou, která určuje, DataColumnjestli 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, jestli je sloupec primárním klíčem, a přidá ho do kolekce.
Add(String, DataColumn[], DataColumn[])	Vytvoří novou ForeignKeyConstraint, se zadanými poli nadřazených sloupců 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řidání Constraint

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. (Porovnání nerozlišuje 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á určuje, DataColumnjestli 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 UniqueConstraint.

column

DataColumn

Omezení DataColumn , na které se omezení vztahuje.

primaryKey

Boolean

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

Návraty

Constraint

Nový UniqueConstraint.

Výjimky

ArgumentException

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

-Or-

Omezení patří do jiné kolekce.

DuplicateNameException

Kolekce již má omezení se zadaným názvem. (Porovnání nerozlišuje 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 .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 dochází, 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 ForeignKeyConstraint.

primaryKeyColumn

DataColumn

Primární klíč nebo nadřazený DataColumnklíč .

foreignKeyColumn

DataColumn

Cizí klíč nebo dítě . DataColumn

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 dochází, 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, jestli 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 UniqueConstraint.

columns

DataColumn[]

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

primaryKey

Boolean

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

Návraty

Constraint

Nový UniqueConstraint.

Výjimky

ArgumentException

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

-Or-

Omezení patří do jiné kolekce.

DuplicateNameException

Kolekce již má omezení se zadaným názvem. (Porovnání nerozlišuje 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 určité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 dochází, pokud je omezení úspěšně přidáno.

Viz také

• UniqueConstraint

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

Zdroj:

ConstraintCollection.cs

Vytvoří novou ForeignKeyConstraint, se zadanými poli nadřazených sloupců 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 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ím klíčem 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 dochází, pokud je omezení úspěšně přidáno.