DataTable.Clear Метод

Определение

Пространство имен:

System.Data

Сборка:

System.Data.Common.dll

Исходный код:

DataTable.cs

Очищает DataTable от всех данных.

public:
 void Clear();

public void Clear ();

member this.Clear : unit -> unit

Public Sub Clear ()

Примеры

В следующем примере показано, как очистить таблицу от всех данных.

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

Комментарии

Все строки во всех таблицах удаляются. Исключение создается, если таблица имеет какие-либо принудительные дочерние отношения, которые могут привести к потере дочерних строк.

DataSet Если объект привязан к XmlDataDocument, вызывает DataSet.Clear или DataTable.Clear вызывает NotSupportedException. Чтобы избежать этой ситуации, просматривайте каждую таблицу, удаляя каждую строку по одной за раз. При использовании для NewRow создания новых строк эти строки должны быть обработаны перед вызовом Clear.

См. также раздел

• DataTables
• Обработка событий таблиц данных