ConstraintCollection.Add Metódus

Definíció

Névtér:

System.Data

Szerelvények:

netstandard.dll, System.Data.Common.dll

Objektumot Constraint ad hozzá a gyűjteményhez.

Túlterhelések

Name	Description
Add(Constraint)	Hozzáadja a megadott Constraint objektumot a gyűjteményhez.
Add(String, DataColumn, Boolean)	Létrehoz egy újat UniqueConstraint a megadott névvel és értékkel, DataColumnamely jelzi, hogy az oszlop elsődleges kulcs-e, és hozzáadja a gyűjteményhez.
Add(String, DataColumn, DataColumn)	Létrehoz egy újat ForeignKeyConstraint a megadott névvel, szülőoszlopmal és gyermekoszlopmal, és hozzáadja a korlátozást a gyűjteményhez.
Add(String, DataColumn[], Boolean)	Létrehoz egy újat UniqueConstraint a megadott névvel, objektumtömbdel DataColumn és értékkel, amely jelzi, hogy az oszlop elsődleges kulcs-e, és hozzáadja a gyűjteményhez.
Add(String, DataColumn[], DataColumn[])	Létrehoz egy újat ForeignKeyConstrainta szülőoszlopok és gyermekoszlopok megadott tömbjeivel, és hozzáadja a korlátozást a gyűjteményhez.

Add(Constraint)

Forrás:

ConstraintCollection.cs

Hozzáadja a megadott Constraint objektumot a gyűjteményhez.

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)

Paraméterek

constraint

Constraint

A Constraint hozzáadni kívánt.

Kivételek

ArgumentNullException

Az constraint argumentum null értékű.

ArgumentException

A korlátozás már ebbe a gyűjteménybe tartozik, vagy egy másik gyűjteményhez tartozik.

DuplicateNameException

A gyűjtemény már rendelkezik ugyanazzal a névvel rendelkező korlátozással. (Az összehasonlítás nem megkülönbözteti a kis- és nagybetűk különbségét.)

Példák

Az alábbi példa ad hozzá egy UniqueConstraintConstraintCollectionDataTable.

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

Megjegyzések

Ha a gyűjtemény a korlátozások hozzáadásával vagy eltávolításával sikeresen módosul, az CollectionChanged esemény bekövetkezik.

Lásd még

• UniqueConstraint
• ForeignKeyConstraint

Add(String, DataColumn, Boolean)

Forrás:

ConstraintCollection.cs

Létrehoz egy újat UniqueConstraint a megadott névvel és értékkel, DataColumnamely jelzi, hogy az oszlop elsődleges kulcs-e, és hozzáadja a gyűjteményhez.

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

Paraméterek

name

String

A UniqueConstraint neve.

column

DataColumn

A DataColumn kényszer hatálya.

primaryKey

Boolean

Megadja, hogy az oszlop legyen-e az elsődleges kulcs. Ha true, az oszlop elsődleges kulcsoszlop lesz.

Válaszok

Constraint

Új UniqueConstraint.

Kivételek

ArgumentException

A korlátozás már ebbe a gyűjteménybe tartozik.

-Or-

A korlátozás egy másik gyűjteményhez tartozik.

DuplicateNameException

A gyűjtemény már rendelkezik a megadott névvel rendelkező korlátozással. (Az összehasonlítás nem megkülönbözteti a kis- és nagybetűk különbségét.)

Példák

Az alábbi példa a Add metódus használatával hoz létre és ad hozzá egy újat UniqueConstraint egy ConstraintCollectionújhoz.

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

Megjegyzések

Az CollectionChanged esemény akkor következik be, ha a kényszert sikeresen hozzáadták.

Lásd még

• UniqueConstraint

Add(String, DataColumn, DataColumn)

Forrás:

ConstraintCollection.cs

Létrehoz egy újat ForeignKeyConstraint a megadott névvel, szülőoszlopmal és gyermekoszlopmal, és hozzáadja a korlátozást a gyűjteményhez.

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

Paraméterek

name

String

A ForeignKeyConstraint neve.

primaryKeyColumn

DataColumn

Az elsődleges kulcs vagy szülő. DataColumn

foreignKeyColumn

DataColumn

Az idegen kulcs vagy gyermek. DataColumn

Válaszok

Constraint

Új ForeignKeyConstraint.

Példák

Az alábbi példa egy újat ForeignKeyConstraint ad hozzá egy ConstraintCollectionDataTable.

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

Megjegyzések

Az CollectionChanged esemény akkor következik be, ha a kényszert sikeresen hozzáadták.

Add(String, DataColumn[], Boolean)

Forrás:

ConstraintCollection.cs

Létrehoz egy újat UniqueConstraint a megadott névvel, objektumtömbdel DataColumn és értékkel, amely jelzi, hogy az oszlop elsődleges kulcs-e, és hozzáadja a gyűjteményhez.

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

Paraméterek

name

String

A UniqueConstraint neve.

columns

DataColumn[]

Objektumtömb DataColumn , amelyre a korlátozás vonatkozik.

primaryKey

Boolean

Megadja, hogy az oszlop legyen-e az elsődleges kulcs. Ha true, az oszlop elsődleges kulcsoszlop lesz.

Válaszok

Constraint

Új UniqueConstraint.

Kivételek

ArgumentException

A korlátozás már ebbe a gyűjteménybe tartozik.

-Or-

A korlátozás egy másik gyűjteményhez tartozik.

DuplicateNameException

A gyűjtemény már rendelkezik a megadott névvel rendelkező korlátozással. (Az összehasonlítás nem megkülönbözteti a kis- és nagybetűk különbségét.)

Példák

Az alábbi példa egy objektumtömböt DataColumn hoz létre, amely egy UniqueConstraint adott DataTableúj elem létrehozásához használható.

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

Megjegyzések

Az CollectionChanged esemény akkor következik be, ha a kényszert sikeresen hozzáadták.

Lásd még

• UniqueConstraint

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

Forrás:

ConstraintCollection.cs

Létrehoz egy újat ForeignKeyConstrainta szülőoszlopok és gyermekoszlopok megadott tömbjeivel, és hozzáadja a korlátozást a gyűjteményhez.

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

Paraméterek

name

String

A ForeignKeyConstraint neve.

primaryKeyColumns

DataColumn[]

Az elsődleges kulcsot vagy szülőoszlopokat tartalmazó objektumtömb DataColumn .

foreignKeyColumns

DataColumn[]

Az idegen kulcs vagy gyermek oszlopokat tartalmazó objektumtömb DataColumn .

Válaszok

Constraint

Új ForeignKeyConstraint.

Példák

Az alábbi példa két objektumtömböt DataColumn hoz létre, majd két ForeignKeyConstraint kapcsolatot hoz létre egy adathalmaz két táblája között.

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

Megjegyzések

Az CollectionChanged esemény akkor következik be, ha a kényszert sikeresen hozzáadták.