DataTable.Clear メソッド

DataTable からすべてのデータを消去します。

Public Sub Clear()
[C#]
public void Clear();
[C++]
public: void Clear();
[JScript]
public function Clear();

解説

すべてのテーブルのすべての行が削除されます。子行を残存させるようなリレーションシップが適用されている場合は、例外が生成されます。

DataSet が XmlDataDocument にバインドされている場合、 DataSet.Clear または DataTable.Clear を呼び出すと NotSupportedException が発生します。これを回避するには、各テーブルを走査し、1 回に 1 行ずつ削除します。

使用例

[Visual Basic, C#, C++] テーブルからすべての行を消去する例を次に示します。

 
Private Sub ClearTable(myTable As DataTable)
    Try
        myTable.Clear()
    Catch e As DataException
    ' Process exception and return.
         Dim log As System.Diagnostics.EventLog = New System.Diagnostics.EventLog()
         log.Source = "My Application"
         log.WriteEntry(e.ToString())
         Console.WriteLine("Exception of type {0} occurred.", e.GetType().ToString())
    End Try
End Sub

[C#] 
private void ClearTable(DataTable myTable){
    try{
       myTable.Clear();
    }
    catch (DataException e){
    // Process exception and return.
        System.Diagnostics.EventLog log = new System.Diagnostics.EventLog();
        log.Source = "My Application";
        log.WriteEntry(e.ToString());
        Console.WriteLine("Exception of type {0} occurred.", e.GetType());
    }
    
 }

[C++] 
private:
void ClearTable(DataTable* myTable){
    try{
       myTable->Clear();
    }
    catch (DataException* e){
    // Process exception and return.
        System::Diagnostics::EventLog* log = new System::Diagnostics::EventLog();
        log->Source = S"My Application";
        log->WriteEntry(e->ToString());
        Console::WriteLine(S"Exception of type {0} occurred.", e->GetType());
    }
    
 }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

DataTable クラス | DataTable メンバ | System.Data 名前空間