DataTable.Clear Methode

Definition

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Quelle:

DataTable.cs

Löscht alle Daten aus der DataTable.

public:
 void Clear();

public void Clear ();

member this.Clear : unit -> unit

Public Sub Clear ()

Beispiele

Im folgenden Beispiel wird die Tabelle aller Daten gelöscht.

private void ClearTable(DataTable table)
{
    try
    {
        table.Clear();
    }
    catch (DataException e)
    {
        // Process exception and return.
        Console.WriteLine("Exception of type {0} occurred.",
            e.GetType());
    }
}

Private Sub ClearTable(table As DataTable)
    Try
        table.Clear()
    Catch e As DataException
    ' Process exception and return.
         Console.WriteLine("Exception of type {0} occurred.", _
           e.GetType().ToString())
    End Try
End Sub

Hinweise

Alle Zeilen in allen Tabellen werden entfernt. Eine Ausnahme wird generiert, wenn die Tabelle über erzwungene untergeordnete Beziehungen verfügt, die dazu führen würden, dass untergeordnete Zeilen verwaist werden.

Wenn der DataSet an einen XmlDataDocumentgebunden ist, ruft DataSet.Clear oder DataTable.Clear löst aus NotSupportedException. Um diese Situation zu vermeiden, durchlaufen Sie jede Tabelle, und entfernen Sie jede Zeile einzeln. Wenn Sie NewRow verwenden, um neue Zeilen zu erstellen, müssen die Zeilen verarbeitet werden, bevor Sie aufrufen Clear.

Weitere Informationen

• "DataTables"
• Behandeln von DataTable-Ereignissen