DataTable.Clear DataTable.Clear DataTable.Clear DataTable.Clear Method

定義

DataTable からすべてのデータを消去します。Clears the DataTable of all data.

public:
 void Clear();
public void Clear ();
member this.Clear : unit -> unit
Public Sub Clear ()

次の例では、すべてのデータのテーブルをクリアします。The following example clears the table of all data.

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

注釈

すべてのテーブルのすべての行が削除されます。All rows in all tables are removed. 表に、子行が孤立するを原因となる任意の強制子リレーションシップがある場合、例外が生成されます。An exception is generated if the table has any enforced child relations that would cause child rows to be orphaned.

場合、DataSetにバインドされて、XmlDataDocumentを呼び出すと、DataSet.ClearまたはDataTable.Clear発生させる、NotSupportedExceptionします。If the DataSet is bound to an XmlDataDocument, calling DataSet.Clear or DataTable.Clear raises the NotSupportedException. このような状況を避けるためには、各テーブルは、一度に 1 行ずつを削除するを走査します。To avoid this situation, traverse each table, removing each row one at a time. 使用するとNewRowを呼び出す前に新しい行を作成する、行を処理する必要がありますClearします。When you use NewRow to create new rows, the rows must be processed before you call Clear.

適用対象

こちらもご覧ください