DataTable.Constraints DataTable.Constraints DataTable.Constraints DataTable.Constraints Property

Definizione

Ottiene l'insieme di vincoli mantenuti da questa tabella.Gets the collection of constraints maintained by this table.

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

Valore della proprietà

Classe ConstraintCollection che contiene l'insieme di oggetti Constraint per la tabella.A ConstraintCollection that contains the collection of Constraint objects for the table. Se non esiste alcun oggetto Constraint viene restituito un insieme vuoto.An empty collection is returned if no Constraint objects exist.

Esempi

Nell'esempio seguente viene aggiunto ForeignKeyConstraint un oggetto alla raccolta di vincoli.The following example adds a ForeignKeyConstraint to the collection of constraints.

   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

Commenti

Un ForeignKeyConstraint limita l'azione eseguita quando un valore in una colonna (o colonne) viene eliminato o aggiornato.A ForeignKeyConstraint restricts the action performed when a value in a column (or columns) is either deleted or updated. Un vincolo di questo tipo è destinato all'uso con colonne chiave primaria.Such a constraint is intended to be used with primary key columns. In una relazione padre/figlio tra due tabelle, l'eliminazione di un valore dalla tabella padre può influire sulle righe figlio in uno dei modi seguenti.In a parent/child relationship between two tables, deleting a value from the parent table can affect the child rows in one of the following ways.

  • È anche possibile eliminare le righe figlio (un'azione a catena).The child rows can also be deleted (a cascading action).

  • I valori della colonna o delle colonne figlio possono essere impostati su valori null.The values in the child column (or columns) can be set to null values.

  • I valori della colonna o delle colonne figlio possono essere impostati sui valori predefiniti.The values in the child column (or columns) can be set to default values.

  • È possibile generare un'eccezione.An exception can be generated.

Un UniqueConstraint diventa attivo quando si tenta di impostare un valore in una chiave primaria su un valore non univoco.A UniqueConstraint becomes active when attempting to set a value in a primary key to a non-unique value.

Si applica a

Vedi anche