Rule Énumération

Définition

Espace de noms:

System.Data

Assemblys:

netstandard.dll, System.Data.Common.dll

Source:

Rule.cs

Indique l’action qui se produit lorsqu’une ForeignKeyConstraint est appliquée.

public enum class Rule

public enum Rule

type Rule = 

Public Enum Rule

Héritage

Object

ValueType

Enum

Rule

Champs

Nom	Valeur	Description
None	0	Aucune action effectuée sur les lignes associées.
Cascade	1	Supprimez ou mettez à jour les lignes associées. Il s’agit de la valeur par défaut.
SetNull	2	Définissez les valeurs dans les lignes associées sur DBNull.
SetDefault	3	Définissez les valeurs dans les lignes associées sur la valeur contenue dans la DefaultValue propriété.

Exemples

' The next line goes into the Declarations section of the module:
' SuppliersProducts is a class derived from DataSet.
Private suppliersProducts As SuppliersProducts

Private Sub CreateConstraint()
    ' Declare parent column and child column variables.
    Dim parentColumn As DataColumn
    Dim childColumn As DataColumn
    Dim fkeyConstraint As ForeignKeyConstraint

    ' Set parent and child column variables.
    parentColumn = suppliersProducts.Tables("Suppliers").Columns("SupplierID")
    childColumn = suppliersProducts.Tables("Products").Columns("SupplierID")
    fkeyConstraint = New ForeignKeyConstraint( _
        "SupplierFKConstraint", parentColumn, childColumn)

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

    ' Add the constraint, and set EnforceConstraints to true.
    suppliersProducts.Tables("Products").Constraints.Add(fkeyConstraint)
    suppliersProducts.EnforceConstraints = True
End Sub

Remarques

Les Rule valeurs sont définies sur les UpdateRule propriétés d’un DeleteRuleForeignKeyConstraint objet trouvés dans le DataTableConstraintCollectionfichier .

Les Rule valeurs déterminent l’action qui se produit lorsqu’une valeur d’une colonne est supprimée ou mise à jour. Parmi les deux, la suppression d’une valeur est plus critique et exigeante de l’attention lors de la définition d’une règle.

Dans le cas où une valeur est supprimée, Cascade spécifie que toutes les lignes contenant cette valeur sont également supprimées. SetNull spécifie que les valeurs de toutes les colonnes enfants sont définies sur des valeurs Null. SetDefault spécifie que toutes les colonnes enfants doivent être définies sur la valeur par défaut de la colonne. None spécifie qu’aucune action ne se produit, mais que les exceptions sont générées.

Dans le cas où une valeur est mise à jour, Cascade spécifie que toutes les colonnes enfants sont également mises à jour avec la nouvelle valeur. SetNull spécifie que toutes les colonnes enfants doivent être définies sur des valeurs Null. SetDefault spécifie que toutes les valeurs de colonne enfant doivent être définies sur la valeur par défaut. None spécifie qu’aucune action n’est effectuée, mais que les exceptions sont générées.

Les contraintes sur un n’ont DataSet pas été appliquées, sauf si la EnforceConstraints propriété est true.

Lorsque la AcceptChanges méthode est appelée, la AcceptRejectRule méthode détermine plus en détail l’action qui se produit.

Voir aussi

• Constraints
• ForeignKeyConstraint