DataTable.Constraints Właściwość

Definicja

Przestrzeń nazw:

System.Data

Zestaw:

System.Data.dll

Pobiera kolekcję ograniczeń obsługiwanych przez tę tabelę.

public:
 property System::Data::ConstraintCollection ^ Constraints { System::Data::ConstraintCollection ^ get(); };

public System.Data.ConstraintCollection Constraints { get; }

member this.Constraints : System.Data.ConstraintCollection

Public ReadOnly Property Constraints As ConstraintCollection

Wartość właściwości

ConstraintCollection

Obiekt ConstraintCollection zawierający kolekcję Constraint obiektów dla tabeli. Pusta kolekcja jest zwracana, jeśli nie Constraint istnieją żadne obiekty.

Przykłady

Poniższy przykład dodaje element ForeignKeyConstraint do kolekcji ograniczeń.

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

Uwagi

Element ForeignKeyConstraint ogranicza akcję wykonywaną, gdy wartość w kolumnie (lub kolumnach) jest usuwana lub aktualizowana. Takie ograniczenie ma być używane z kolumnami klucza podstawowego. W relacji nadrzędnej/podrzędnej między dwiema tabelami usunięcie wartości z tabeli nadrzędnej może mieć wpływ na wiersze podrzędne w jeden z następujących sposobów.

• Wiersze podrzędne można również usunąć (akcja kaskadowa).

• Wartości w kolumnie podrzędnej (lub kolumnach) można ustawić na wartości null.

• Wartości w kolumnie podrzędnej (lub kolumnach) można ustawić na wartości domyślne.

• Można wygenerować wyjątek.

Element UniqueConstraint staje się aktywny podczas próby ustawienia wartości w kluczu podstawowym na wartość inną niż unikatowa.

Zobacz też

• Tabele danych