一括削除 (C#)

2025-04-30

1 回の操作で複数のデータベースレコードを削除する方法について説明します。ユーザーインターフェイスレイヤーでは、前のチュートリアルで作成した強化された GridView を基に構築します。データアクセス層では、トランザクション内で複数の削除操作をラップして、すべての削除が成功するか、すべての削除がロールバックされるようにします。

イントロダクション

前のチュートリアルでは、完全に編集可能な GridView を使用してバッチ編集インターフェイスを作成する方法について説明しました。ユーザーが一度に多くのレコードを一度に編集する状況では、バッチ編集インターフェイスで必要なポストバックとキーボードからマウスへのコンテキストスイッチがはるかに少なくなり、エンドユーザーの効率が向上します。この手法は、ユーザーが一度に多数のレコードを削除するのが一般的なページでも同様に便利です。

オンラインメールクライアントを使用したユーザーは、最も一般的なバッチ削除インターフェイスの 1 つである、対応する [すべてのチェック済みアイテムの削除] ボタンを含むグリッド内の各行のチェックボックスに既に精通しています (図 1 を参照)。このチュートリアルは、Web ベースのインターフェイスと、一連のレコードを 1 つのアトミック操作として削除するメソッドの両方を作成する前のチュートリアルのすべてのハード作業を既に行っているため、かなり短いです。「チェックボックスの GridView 列の追加」チュートリアルでは、チェックボックスの列を含む GridView を作成し、「トランザクション内のデータベース変更の折り返し」チュートリアルで、トランザクションを使用してList<T>値のProductIDを削除するメソッドを BLL で作成しました。このチュートリアルでは、前のエクスペリエンスを基に構築し、マージして、実際のバッチ削除の例を作成します。

図 1: 各行にチェックボックスが含まれています (フルサイズの画像を表示する場合はクリックします)

手順 1: バッチ削除インターフェイスの作成

「チェックボックスの GridView 列の追加」チュートリアルでバッチ削除インターフェイスを既に作成しているため、最初から作成するのではなく、BatchDelete.aspxにコピーするだけです。まず、BatchDelete.aspx フォルダーのBatchData ページと、CheckBoxField.aspx フォルダー内の EnhancedGridView ページを開きます。 CheckBoxField.aspx ページからソースビューに移動し、図 2 に示すように、<asp:Content> タグ間でマークアップをコピーします。

図 2: CheckBoxField.aspx の宣言型マークアップをクリップボードにコピーする (フルサイズの画像を表示するをクリックします)

次に、 BatchDelete.aspx のソースビューに移動し、 <asp:Content> タグ内にクリップボードの内容を貼り付けます。また、CheckBoxField.aspx.csの分離コードクラス内からBatchDelete.aspx.csの分離コードクラス内にコードをコピーして貼り付けます (DeleteSelectedProducts Button のClickイベントハンドラー、ToggleCheckState メソッド、およびClickおよびCheckAll Buttons のUncheckAllイベントハンドラー)。このコンテンツをコピーした後、BatchDelete.aspx ページのコードビハインドクラスには次のコードを含む必要があります。

using System;
using System.Data;
using System.Configuration;
using System.Collections;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;
public partial class BatchData_BatchDelete : System.Web.UI.Page
{
    protected void DeleteSelectedProducts_Click(object sender, EventArgs e)
    {
        bool atLeastOneRowDeleted = false;
        // Iterate through the Products.Rows property
        foreach (GridViewRow row in Products.Rows)
        {
            // Access the CheckBox
            CheckBox cb = (CheckBox)row.FindControl("ProductSelector");
            if (cb != null && cb.Checked)
            {
                // Delete row! (Well, not really...)
                atLeastOneRowDeleted = true;
                // First, get the ProductID for the selected row
                int productID = Convert.ToInt32(Products.DataKeys[row.RowIndex].Value);
                // "Delete" the row
                DeleteResults.Text += string.Format
                    ("This would have deleted ProductID {0}<br />", productID);
                //... To actually delete the product, use ...
                //ProductsBLL productAPI = new ProductsBLL();
                //productAPI.DeleteProduct(productID);
                //............................................
            }
        }
        // Show the Label if at least one row was deleted...
        DeleteResults.Visible = atLeastOneRowDeleted;
    }
    private void ToggleCheckState(bool checkState)
    {
        // Iterate through the Products.Rows property
        foreach (GridViewRow row in Products.Rows)
        {
            // Access the CheckBox
            CheckBox cb = (CheckBox)row.FindControl("ProductSelector");
            if (cb != null)
                cb.Checked = checkState;
        }
    }
    protected void CheckAll_Click(object sender, EventArgs e)
    {
        ToggleCheckState(true);
    }
    protected void UncheckAll_Click(object sender, EventArgs e)
    {
        ToggleCheckState(false);
    }
}

宣言型マークアップとソースコードをコピーした後、ブラウザーで表示して BatchDelete.aspx をテストします。 GridView に最初の 10 個の製品が一覧表示され、各行に製品名、カテゴリ、価格がチェックボックスと共に一覧表示されます。 [すべてオン]、[すべてオフ]、[選択した製品の削除] の 3 つのボタンが必要です。 [すべてチェック]ボタンをクリックするとすべてのチェックボックスが選択され、[すべてオフ]はすべてのチェックボックスをオフにします。 [選択した製品の削除] をクリックすると、選択した製品の ProductID 値を一覧表示するメッセージが表示されますが、実際には製品は削除されません。

図 3: CheckBoxField.aspx からのインターフェイスが BatchDeleting.aspx に移動されました (フルサイズの画像を表示するをクリックします)。

手順 2: トランザクションを使用してチェックされた製品を削除する

バッチ削除インターフェイスがBatchDeleting.aspxに正常にコピーされた場合、残っているのは、DeleteProductsWithTransaction クラスの ProductsBLL メソッドを使用して、選択した製品の削除ボタンがチェックされた製品を削除するようにコードを更新することです。トランザクション内のデータベース変更の折り返しチュートリアルで追加されたこのメソッドは、List<T>値のProductIDを入力として受け入れ、トランザクションのスコープ内の対応する各ProductIDを削除します。

DeleteSelectedProducts Button のClick イベントハンドラーは、現在、次のforeach ループを使用して各 GridView 行を反復処理します。

// Iterate through the Products.Rows property
foreach (GridViewRow row in Products.Rows)
{
    // Access the CheckBox
    CheckBox cb = (CheckBox)row.FindControl("ProductSelector");
    if (cb != null && cb.Checked)
    {
        // Delete row! (Well, not really...)
        atLeastOneRowDeleted = true;
        // First, get the ProductID for the selected row
        int productID = Convert.ToInt32(Products.DataKeys[row.RowIndex].Value);
        // "Delete" the row
        DeleteResults.Text += string.Format
            ("This would have deleted ProductID {0}<br />", productID);
        //... To actually delete the product, use ...
        //ProductsBLL productAPI = new ProductsBLL();
        //productAPI.DeleteProduct(productID);
        //............................................
    }
}

行ごとに、 ProductSelector CheckBox Web コントロールがプログラムによって参照されます。オンにすると、ProductID コレクションから行のDataKeysが取得され、DeleteResults Label のText プロパティが更新され、その行が削除対象として選択されたことを示すメッセージが含まれます。

上記のコードでは、 ProductsBLL クラスの Delete メソッドの呼び出しがコメントアウトされるため、実際にはレコードは削除されません。この削除ロジックを適用すると、コードはアトミック操作内ではなく製品を削除します。つまり、シーケンス内の最初のいくつかの削除が成功したが、後で失敗した場合 (おそらく外部キー制約違反が原因)、例外がスローされますが、既に削除された製品は削除されたままです。

原子性を確保するには、代わりに ProductsBLL クラスの DeleteProductsWithTransaction メソッドを使用する必要があります。このメソッドは ProductID 値のリストを受け取るため、最初にグリッドからこのリストをコンパイルしてから、パラメーターとして渡す必要があります。最初に、List<T>型のintのインスタンスを作成します。 foreach ループ内で、選択した製品ProductID値をこのList<T>に追加する必要があります。ループの後、この List<T> を ProductsBLL クラスの DeleteProductsWithTransaction メソッドに渡す必要があります。 DeleteSelectedProducts Button Click イベントハンドラーを次のコードで更新します。

protected void DeleteSelectedProducts_Click(object sender, EventArgs e)
{
    // Create a List to hold the ProductID values to delete
    System.Collections.Generic.List<int> productIDsToDelete = 
        new System.Collections.Generic.List<int>();
    // Iterate through the Products.Rows property
    foreach (GridViewRow row in Products.Rows)
    {
        // Access the CheckBox
        CheckBox cb = (CheckBox)row.FindControl("ProductSelector");
        if (cb != null && cb.Checked)
        {
            // Save the ProductID value for deletion
            // First, get the ProductID for the selected row
            int productID = Convert.ToInt32(Products.DataKeys[row.RowIndex].Value);
            // Add it to the List...
            productIDsToDelete.Add(productID);
            // Add a confirmation message
            DeleteResults.Text += string.Format
                ("ProductID {0} has been deleted<br />", productID);
        }
    }
    // Call the DeleteProductsWithTransaction method and show the Label 
    // if at least one row was deleted...
    if (productIDsToDelete.Count > 0)
    {
        ProductsBLL productAPI = new ProductsBLL();
        productAPI.DeleteProductsWithTransaction(productIDsToDelete);
        DeleteResults.Visible = true;
        // Rebind the data to the GridView
        Products.DataBind();
    }
}

更新されたコードは、List<T> (int) 型のproductIDsToDeleteを作成し、削除するProductID値を設定します。 foreach ループの後に、少なくとも 1 つの製品が選択されている場合、ProductsBLL クラスの DeleteProductsWithTransaction メソッドが呼び出され、このリストが渡されます。 DeleteResultsラベルも表示され、データは GridView にリバインドされます (新しく削除されたレコードがグリッド内の行として表示されなくなります)。

図 4 は、複数の行が削除対象として選択された後の GridView を示しています。図 5 は、[選択した製品の削除] ボタンがクリックされた直後の画面を示しています。図 5 では、削除されたレコードの ProductID 値が GridView の下のラベルに表示され、それらの行は GridView に表示されなくなります。

図 4: 選択した製品が削除されます (フルサイズの画像を表示するをクリックします)

図 5: 削除された製品 ProductID 値が GridView の下に一覧表示されます (フルサイズの画像を表示するをクリックします)。

注

DeleteProductsWithTransaction メソッドのアトミック性をテストするには、Order Details テーブルに製品のエントリを手動で追加し、その製品を (他のユーザーと共に) 削除します。関連する注文を含む製品を削除しようとすると、外部キー制約違反が発生しますが、選択した他の製品の削除がどのようにロールバックされるかに注意してください。

概要

バッチ削除インターフェイスを作成するには、チェックボックスの列とボタン Web コントロールを含む GridView を追加する必要があります。ボタン Web コントロールをクリックすると、選択したすべての行が 1 つのアトミック操作として削除されます。このチュートリアルでは、前の 2 つのチュートリアル「チェックボックスの GridView 列の追加」と「トランザクション内のデータベース変更の折り返し」で行った作業をまとめて、このようなインターフェイスを構築しました。最初のチュートリアルでは、チェックボックスの列を含む GridView を作成し、後者では、List<T>値のProductIDを渡すと、トランザクションのスコープ内でそれらをすべて削除するメソッドを BLL に実装しました。

次のチュートリアルでは、バッチ挿入を実行するためのインターフェイスを作成します。

プログラミングに満足!

著者について

7 冊の ASP/ASP.NET 書籍の著者であり、4GuysFromRolla.com の創設者である Scott Mitchell は、1998 年から Microsoft Web テクノロジを使用しています。 Scott は、独立したコンサルタント、トレーナー、ライターとして働いています。彼の最新の本は サムズ・ティーチ・セルフ ASP.NET 24時間で2.0です。彼には mitchell@4GuysFromRolla.comで連絡できます。

特別な感謝

このチュートリアルシリーズは、多くの役に立つ校閲者によってレビューされました。このチュートリアルのリードレビュー担当者は、ヒルトンギセナウとテレサマーフィーでした。今後の MSDN の記事を確認することに関心がありますか? その場合は、mitchell@4GuysFromRolla.comにご連絡ください。

前へ次へ