GridViewDeleteEventArgs クラス
アセンブリ: System.Web (system.web.dll 内)
構文解説GridView コントロールは、Delete ボタン (CommandName プロパティが "Delete" に設定されたボタン) がクリックされた場合に、GridView コントロールでレコードを削除する前に RowDeleting イベントを発生させます。これにより、このイベントが発生するたびにカスタム ルーチン (削除操作のキャンセルなど) を実行するイベント処理メソッドを提供できます。
GridViewDeleteEventArgs オブジェクトがイベント処理メソッドに渡されることにより、削除される行のインデックスを確認したり、削除操作をキャンセルする必要があることを示したりできます。削除操作をキャンセルするには、GridViewDeleteEventArgs オブジェクトの Cancel プロパティを true に設定します。また、必要に応じて、値がデータ ソースに渡される前に Keys コレクションと Values コレクションを操作することもできます。
イベント処理の詳細については、「イベントの利用」を参照してください。
GridViewDeleteEventArgs のインスタンスの初期プロパティ値の一覧については、GridViewDeleteEventArgs コンストラクタのトピックを参照してください。
使用例イベント処理メソッドに渡された GridViewDeleteEventArgs オブジェクトを使用して、ユーザーが GridView コントロールの最後のレコードを削除しようとしたときに削除操作をキャンセルする方法を次の例に示します。
<%@ Page language="VB" %> <script runat="server"> Sub CustomersGridView_RowDeleting(ByVal sender As Object, ByVal e As GridViewDeleteEventArgs) ' Cancel the delete operation if the user attempts to remove ' the last record from the GridView control. If CustomersGridView.Rows.Count <= 1 Then e.Cancel = True Message.Text = "You must keep at least one record." End If End Sub </script> <html> <body> <form runat="server"> <h3>GridView RowDeleting Example</h3> <asp:label id="Message" forecolor="Red" runat="server"/> <br/> <!-- The GridView control automatically sets the columns --> <!-- specified in the datakeynames property as read-only. --> <!-- No input controls are rendered for these columns in --> <!-- edit mode. --> <asp:gridview id="CustomersGridView" datasourceid="CustomersSqlDataSource" autogeneratecolumns="true" autogeneratedeletebutton="true" datakeynames="CustomerID" onrowdeleting="CustomersGridView_RowDeleting" runat="server"> </asp:gridview> <!-- This example uses Microsoft SQL Server and connects --> <!-- to the Northwind sample database. Use an ASP.NET --> <!-- expression to retrieve the connection string value --> <!-- from the Web.config file. --> <asp:sqldatasource id="CustomersSqlDataSource" selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]" deletecommand="Delete from Customers where CustomerID = @CustomerID" connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" runat="server"> </asp:sqldatasource> </form> </body> </html>
<%@ Page language="C#" %> <script runat="server"> void CustomersGridView_RowDeleting(Object sender, GridViewDeleteEventArgs e) { // Cancel the delete operation if the user attempts to remove // the last record from the GridView control. if (CustomersGridView.Rows.Count <= 1) { e.Cancel = true; Message.Text = "You must keep at least one record."; } } </script> <html> <body> <form runat="server"> <h3>GridView RowDeleting Example</h3> <asp:label id="Message" forecolor="Red" runat="server"/> <br/> <!-- The GridView control automatically sets the columns --> <!-- specified in the datakeynames property as read-only. --> <!-- No input controls are rendered for these columns in --> <!-- edit mode. --> <asp:gridview id="CustomersGridView" datasourceid="CustomersSqlDataSource" autogeneratecolumns="true" autogeneratedeletebutton="true" datakeynames="CustomerID" onrowdeleting="CustomersGridView_RowDeleting" runat="server"> </asp:gridview> <!-- This example uses Microsoft SQL Server and connects --> <!-- to the Northwind sample database. Use an ASP.NET --> <!-- expression to retrieve the connection string value --> <!-- from the Web.config file. --> <asp:sqldatasource id="CustomersSqlDataSource" selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]" deletecommand="Delete from Customers where CustomerID = @CustomerID" connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" runat="server"> </asp:sqldatasource> </form> </body> </html>
.NET Framework のセキュリティ継承階層System.EventArgs
System.ComponentModel.CancelEventArgs
System.Web.UI.WebControls.GridViewDeleteEventArgs
スレッド セーフプラットフォームWindows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照Weblioに収録されているすべての辞書からGridViewDeleteEventArgs クラスを検索する場合は、下記のリンクをクリックしてください。
全ての辞書からGridViewDeleteEventArgs クラス
を検索
- GridViewDeleteEventArgs クラスのページへのリンク
