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

L'esempio seguente aggiunge un ForeignKeyConstraint 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

Oggetto 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. Tale vincolo deve essere usato 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ò influenzare le 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.

  • L'elemento figlio possono essere anche le righe eliminate (un'operazione di propagazione).The child rows can also be deleted (a cascading action).

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

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

  • Può essere generata un'eccezione.An exception can be generated.

Oggetto UniqueConstraint diventa attiva durante il tentativo di impostare un valore di 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