DataTable.Constraints Propriété

Définition

Obtient la collection de contraintes gérée par cette table.

public:
 property System::Data::ConstraintCollection ^ Constraints { System::Data::ConstraintCollection ^ get(); };
public System.Data.ConstraintCollection Constraints { get; }
[System.Data.DataSysDescription("DataTableConstraintsDescr")]
public System.Data.ConstraintCollection Constraints { get; }
member this.Constraints : System.Data.ConstraintCollection
[<System.Data.DataSysDescription("DataTableConstraintsDescr")>]
member this.Constraints : System.Data.ConstraintCollection
Public ReadOnly Property Constraints As ConstraintCollection

Valeur de propriété

ConstraintCollection qui contient la collection des objets Constraint pour la table. Une collection vide est retournée si aucun objet Constraint n'existe.

Attributs

Exemples

L’exemple suivant ajoute un ForeignKeyConstraint à la collection de contraintes.

private void CreateConstraint(DataSet dataSet,
    string table1, string table2, string column1, string column2)
{
    ForeignKeyConstraint idKeyRestraint = new
        ForeignKeyConstraint(dataSet.Tables[table1].Columns[column1],
        dataSet.Tables[table2].Columns[column2]);

    // Set null values when a value is deleted.
    idKeyRestraint.DeleteRule = Rule.SetNull;
    idKeyRestraint.UpdateRule = Rule.Cascade;

    // Set AcceptRejectRule to cascade changes.
    idKeyRestraint.AcceptRejectRule = AcceptRejectRule.Cascade;

    dataSet.Tables[table1].Constraints.Add(idKeyRestraint);
    dataSet.EnforceConstraints = true;
}
Private Sub CreateConstraint(dataSet As DataSet, _
    table1 As String, table2 As String, _
    column1 As String, column2 As String)

    Dim idKeyRestraint As ForeignKeyConstraint = _
        New ForeignKeyConstraint _
        (dataSet.Tables(table1).Columns(column1), _
        dataSet.Tables(table2).Columns(column2))

    ' Set null values when a value is deleted.
    idKeyRestraint.DeleteRule = Rule.SetNull
    idKeyRestraint.UpdateRule = Rule.Cascade

    ' Set AcceptRejectRule to cascade changes.
    idKeyRestraint.AcceptRejectRule = AcceptRejectRule.Cascade
    
    dataSet.Tables(table1).Constraints.Add(idKeyRestraint)
    dataSet.EnforceConstraints = True
End Sub

Remarques

Un ForeignKeyConstraint limite l’action effectuée lorsqu’une valeur d’une colonne (ou de colonnes) est supprimée ou mise à jour. Une telle contrainte est destinée à être utilisée avec les colonnes de clé primaire. Dans une relation parent/enfant entre deux tables, la suppression d’une valeur de la table parente peut affecter les lignes enfants de l’une des manières suivantes.

  • Les lignes enfants peuvent également être supprimées (action en cascade).

  • Les valeurs de la colonne enfant (ou des colonnes) peuvent être définies sur des valeurs null.

  • Les valeurs de la colonne enfant (ou des colonnes) peuvent être définies sur les valeurs par défaut.

  • Une exception peut être générée.

Un UniqueConstraint devient actif lors de la tentative de définition d’une valeur dans une clé primaire sur une valeur non unique.

S’applique à

Voir aussi