ConstraintCollection.CanRemove-Methode

Gibt an, ob eine Constraint entfernt werden kann.

Namespace: System.Data
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Public Function CanRemove ( _
    constraint As Constraint _
) As Boolean
'Usage
Dim instance As ConstraintCollection
Dim constraint As Constraint
Dim returnValue As Boolean

returnValue = instance.CanRemove(constraint)

public bool CanRemove (
    Constraint constraint
)

public:
bool CanRemove (
    Constraint^ constraint
)

public boolean CanRemove (
    Constraint constraint
)

public function CanRemove (
    constraint : Constraint
) : boolean

Parameter

• constraint
  Die Constraint, für die untersucht werden soll, ob sie aus der Auflistung entfernt werden kann.

Rückgabewert

true, wenn die Constraint entfernt werden kann; andernfalls false.

Hinweise

Immer wenn eine DataRelation einem DataSet hinzugefügt wird, gilt folgendes Standardverhalten: Eine ForeignKeyConstraint wird der übergeordneten Tabelle und eine UniqueConstraint wird der untergeordneten Tabelle hinzugefügt. Die UniqueConstraint wird auf die Primärschlüsselspalte der übergeordneten Tabelle angewendet, und die ForeignKeyConstraint wird auf die Fremdschlüsselspalte der untergeordneten Tabelle angewendet. Da der Versuch, die UniqueConstraint vor der ForeignKeyConstraint zu entfernen, eine Ausnahme auslöst, sollten Sie stets die CanRemove-Methode verwenden, um sicherzustellen, dass die UniqueConstraint entfernt werden kann.

Beispiel

Im folgenden Beispiel wird mithilfe der CanRemove-Methode ermittelt, ob eine Constraint entfernt werden kann, bevor versucht wird, diese zu entfernen.

Private Sub TryRemove(dataSet As DataSet)
    Try
        Dim customersTable As DataTable = dataSet.Tables("Customers")
        Dim constraint As Constraint = customersTable.Constraints(0)
        Console.WriteLine("Can remove? " & _
            customersTable.Constraints.CanRemove(constraint).ToString())

    Catch ex As Exception
        ' Process exception and return.
        Console.WriteLine("Exception of type {0} occurred.", _
            ex.GetType().ToString())
    End Try
End Sub

private void TryRemove(DataSet dataSet)
{
    try
    {
        DataTable customersTable = dataSet.Tables["Customers"];
        Constraint constraint = customersTable.Constraints[0];
        Console.WriteLine("Can remove? " + 
            customersTable.Constraints.CanRemove(constraint));
    }
    catch(Exception ex) 
    {
        // Process exception and return.
        Console.WriteLine("Exception of type {0} occurred.", 
            ex.GetType());
    }
}

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

ConstraintCollection-Klasse
ConstraintCollection-Member
System.Data-Namespace