GridView.RowEditing イベント
メモ : このイベントは、.NET Framework version 2.0 で新しく追加されたものです。 行の Edit ボタンがクリックされた場合に、GridView コントロールが編集モードになる前に発生します。 名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文
解説
使用例
プラットフォーム
バージョン情報
参照
アセンブリ: System.Web (system.web.dll 内)
構文Dim instance As GridView Dim handler As GridViewEditEventHandler AddHandler instance.RowEditing, handler
public: event GridViewEditEventHandler^ RowEditing { void add (GridViewEditEventHandler^ value); void remove (GridViewEditEventHandler^ value); }
解説RowEditing イベントは、行の Edit ボタンがクリックされた場合に、GridView コントロールが編集モードになる前に発生します。これにより、このイベントが発生するたびにカスタム ルーチン (編集操作のキャンセルなど) を実行するイベント処理メソッドを提供できます。
GridViewEditEventArgs オブジェクトがイベント処理メソッドに渡されることにより、現在の行のインデックスを確認したり、編集操作をキャンセルする必要があることを示したりできます。編集操作をキャンセルするには、GridViewEditEventArgs オブジェクトの Cancel プロパティを true に設定します。
使用例RowEditing イベントを使用して、ユーザーが米国の企業のレコードを編集しようとした場合に編集操作をキャンセルする方法を次のコード例に示します。
<%@ Page language="VB" %> <script runat="server"> Sub CustomersGridView_RowEditing(ByVal sender As Object, ByVal e As GridViewEditEventArgs) ' Get the country for the row being edited. For this example, the ' country is contained in the seventh column (index 6). Dim country As String = CustomersGridView.Rows(e.NewEditIndex).Cells(6).Text ' For this example, cancel the edit operation if the user attempts ' to edit the record of a customer from the United States. If country = "USA" Then ' Cancel the edit operation. e.Cancel = True Message.Text = "You cannot edit this record." Else Message.Text = "" End If End Sub </script> <html> <body> <form runat="server"> <h3>GridView RowEditing 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" autogenerateeditbutton="true" allowpaging="true" datakeynames="CustomerID" onrowediting="CustomersGridView_RowEditing" 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]" updatecommand="Update Customers SET CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country WHERE (CustomerID = @CustomerID)" connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" runat="server"> </asp:sqldatasource> </form> </body> </html>
<%@ Page language="C#" %> <script runat="server"> void CustomersGridView_RowEditing(Object sender, GridViewEditEventArgs e) { // Get the country for the row being edited. For this example, the // country is contained in the seventh column (index 6). String country = CustomersGridView.Rows[e.NewEditIndex].Cells[6].Text; // For this example, cancel the edit operation if the user attempts // to edit the record of a customer from the Unites States. if (country == "USA") { // Cancel the edit operation. e.Cancel = true; Message.Text = "You cannot edit this record."; } else { Message.Text = ""; } } </script> <html> <body> <form runat="server"> <h3>GridView RowEditing 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" autogenerateeditbutton="true" allowpaging="true" datakeynames="CustomerID" onrowediting="CustomersGridView_RowEditing" 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]" updatecommand="Update Customers SET CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country WHERE (CustomerID = @CustomerID)" connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" runat="server"> </asp:sqldatasource> </form> </body> </html>
プラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照- GridView.RowEditing イベントのページへのリンク
