ConstraintCollection.Add Methode

Definitie

Naamruimte:: System.Data

Assembly's:: netstandard.dll, System.Data.Common.dll

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee voegt u een Constraint object toe aan de verzameling.

Overloads

Name	Description
Add(Constraint)	Hiermee voegt u het opgegeven Constraint object toe aan de verzameling.
Add(String, DataColumn, Boolean)	Hiermee maakt u een nieuwe UniqueConstraint met de opgegeven naam DataColumnen waarde die aangeeft of de kolom een primaire sleutel is en deze toevoegt aan de verzameling.
Add(String, DataColumn, DataColumn)	Hiermee maakt u een nieuwe ForeignKeyConstraint met de opgegeven naam, bovenliggende kolom en onderliggende kolom en voegt u de beperking toe aan de verzameling.
Add(String, DataColumn[], Boolean)	Hiermee maakt u een nieuwe UniqueConstraint met de opgegeven naam, matrix van DataColumn objecten en waarde die aangeeft of de kolom een primaire sleutel is en deze toevoegt aan de verzameling.
Add(String, DataColumn[], DataColumn[])	Hiermee maakt u een nieuwe ForeignKeyConstraint, met de opgegeven matrices van bovenliggende kolommen en onderliggende kolommen en voegt u de beperking toe aan de verzameling.

Add(Constraint)

Bron:: ConstraintCollection.cs

Bron:: ConstraintCollection.cs

Bron:: ConstraintCollection.cs

Bron:: ConstraintCollection.cs

Bron:: ConstraintCollection.cs

Hiermee voegt u het opgegeven Constraint object toe aan de verzameling.

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)

Parameters

constraint: Constraint

De Constraint te toevoegen.

Uitzonderingen

ArgumentNullException

Het constraint argument is null.

ArgumentException

De beperking behoort al tot deze verzameling of behoort tot een andere verzameling.

DuplicateNameException

De verzameling heeft al een beperking met dezelfde naam. (De vergelijking is niet hoofdlettergevoelig.)

Voorbeelden

In het volgende voorbeeld wordt een UniqueConstraint aan de ConstraintCollection van een 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

Opmerkingen

Als de verzameling is gewijzigd door beperkingen toe te voegen of te verwijderen, vindt de CollectionChanged gebeurtenis plaats.

Zie ook

Van toepassing op

Add(String, DataColumn, Boolean)

Bron:: ConstraintCollection.cs

Bron:: ConstraintCollection.cs

Bron:: ConstraintCollection.cs

Bron:: ConstraintCollection.cs

Bron:: ConstraintCollection.cs

Hiermee maakt u een nieuwe UniqueConstraint met de opgegeven naam DataColumnen waarde die aangeeft of de kolom een primaire sleutel is en deze toevoegt aan de verzameling.

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

Parameters

name: String

De naam van de UniqueConstraint.

column: DataColumn

De DataColumn beperking waarop de beperking van toepassing is.

primaryKey: Boolean

Hiermee geeft u op of de kolom de primaire sleutel moet zijn. Als true, is de kolom een primaire-sleutelkolom.

Retouren

Constraint

Een nieuwe UniqueConstraint.

Uitzonderingen

ArgumentException

De beperking behoort al tot deze verzameling.

-Of-

De beperking behoort tot een andere verzameling.

DuplicateNameException

De verzameling heeft al een beperking met de opgegeven naam. (De vergelijking is niet hoofdlettergevoelig.)

Voorbeelden

In het volgende voorbeeld wordt de Add methode gebruikt om een nieuwe UniqueConstraint te maken en toe te voegen aan een 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

Opmerkingen

De CollectionChanged gebeurtenis treedt op als de beperking is toegevoegd.

Zie ook

UniqueConstraint

Van toepassing op

Add(String, DataColumn, DataColumn)

Bron:: ConstraintCollection.cs

Bron:: ConstraintCollection.cs

Bron:: ConstraintCollection.cs

Bron:: ConstraintCollection.cs

Bron:: ConstraintCollection.cs

Hiermee maakt u een nieuwe ForeignKeyConstraint met de opgegeven naam, bovenliggende kolom en onderliggende kolom en voegt u de beperking toe aan de verzameling.

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

Parameters

name: String

De naam van de ForeignKeyConstraint.

primaryKeyColumn: DataColumn

De primaire sleutel of bovenliggende sleutel DataColumn.

foreignKeyColumn: DataColumn

De refererende sleutel, of kind, DataColumn.

Retouren

Constraint

Een nieuwe ForeignKeyConstraint.

Voorbeelden

In het volgende voorbeeld wordt een nieuwe ForeignKeyConstraint toegevoegd aan een ConstraintCollection 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

Opmerkingen

De CollectionChanged gebeurtenis treedt op als de beperking is toegevoegd.

Van toepassing op

Add(String, DataColumn[], Boolean)

Bron:: ConstraintCollection.cs

Bron:: ConstraintCollection.cs

Bron:: ConstraintCollection.cs

Bron:: ConstraintCollection.cs

Bron:: ConstraintCollection.cs

Hiermee maakt u een nieuwe UniqueConstraint met de opgegeven naam, matrix van DataColumn objecten en waarde die aangeeft of de kolom een primaire sleutel is en deze toevoegt aan de verzameling.

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

Parameters

name: String

De naam van de UniqueConstraint.

columns: DataColumn[]

Een matrix van DataColumn objecten waarop de beperking van toepassing is.

primaryKey: Boolean

Hiermee geeft u op of de kolom de primaire sleutel moet zijn. Als true, is de kolom een primaire-sleutelkolom.

Retouren

Constraint

Een nieuwe UniqueConstraint.

Uitzonderingen

ArgumentException

De beperking behoort al tot deze verzameling.

-Of-

De beperking behoort tot een andere verzameling.

DuplicateNameException

De verzameling heeft al een beperking met de opgegeven naam. (De vergelijking is niet hoofdlettergevoelig.)

Voorbeelden

In het volgende voorbeeld wordt een matrix gemaakt met DataColumn objecten die worden gebruikt om een nieuw UniqueConstraint object in een specifieke DataTablete maken.

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

Opmerkingen

De CollectionChanged gebeurtenis treedt op als de beperking is toegevoegd.

Zie ook

UniqueConstraint

Van toepassing op

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

Bron:: ConstraintCollection.cs

Bron:: ConstraintCollection.cs

Bron:: ConstraintCollection.cs

Bron:: ConstraintCollection.cs

Bron:: ConstraintCollection.cs

Hiermee maakt u een nieuwe ForeignKeyConstraint, met de opgegeven matrices van bovenliggende kolommen en onderliggende kolommen en voegt u de beperking toe aan de verzameling.

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

Parameters

name: String

De naam van de ForeignKeyConstraint.

primaryKeyColumns: DataColumn[]

Een matrix met DataColumn objecten die de primaire sleutel of bovenliggende kolommen zijn.

foreignKeyColumns: DataColumn[]

Een matrix met DataColumn objecten die de refererende sleutel of onderliggende kolommen zijn.

Retouren

Constraint

Een nieuwe ForeignKeyConstraint.

Voorbeelden

In het volgende voorbeeld worden twee matrices met DataColumn objecten gemaakt en vervolgens twee ForeignKeyConstraint relaties tussen twee tabellen in een gegevensset gemaakt.

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

Opmerkingen

De CollectionChanged gebeurtenis treedt op als de beperking is toegevoegd.

Van toepassing op

Feedback

Is deze pagina nuttig?