GridView.AutoGenerateEditButton プロパティ
アセンブリ: System.Web (system.web.dll 内)
構文Dim instance As GridView Dim value As Boolean value = instance.AutoGenerateEditButton instance.AutoGenerateEditButton = value
/** @property */ public boolean get_AutoGenerateEditButton () /** @property */ public void set_AutoGenerateEditButton (boolean value)
public function get AutoGenerateEditButton () : boolean public function set AutoGenerateEditButton (value : boolean)
データ行ごとに Edit ボタンを持つ CommandField フィールド列を自動的に追加する場合は true。それ以外の場合は false。既定値は false です。
解説更新機能をサポートしているデータ ソース コントロールが GridView コントロールにバインドされている場合、GridView コントロールは、データ ソース コントロールの機能を利用して、自動更新機能を提供します。
.gif) メモ |
|---|
| データを更新するデータ ソース コントロールの場合、データを更新するように構成する必要があります。レコードを更新するデータ ソース コントロールの構成については、該当するデータ ソース コントロールのドキュメントを参照してください。 |
AutoGenerateEditButton プロパティが true に設定されている場合、データ行ごとに Edit ボタンを持つ (CommandField オブジェクトで表される) 列が自動的に GridView コントロールに追加されます。行の Edit ボタンをクリックすると、行が編集モードになります。行が編集モードになっている場合、行の読み取り専用ではない各列フィールドに、そのフィールドのデータ型に適した入力コントロール (TextBox コントロールなど) が表示されます。これにより、ユーザーがフィールドの値を変更できます。
また、Edit ボタンはクリックされると、Update ボタンと Cancel ボタンに置き換えられます。Update ボタンをクリックすると、変更された値でデータ ソース内の行が更新され、行が表示モードに戻ります。Cancel ボタンをクリックすると、値の変更が破棄され、行が表示モードに戻ります。
| メモ |
|---|
| EditIndex プロパティに行のインデックスを設定して、プログラムによって行を編集モードにできます。プログラムによって編集モードを終了するには、EditIndex プロパティを -1 に設定します。 |
組み込みの更新機能を使用する場合は、DataKeyNames プロパティにコンマ区切りのフィールド名リストを設定して、データ ソースの 1 つ以上の主キー フィールドを指定する必要があります。そうしないと、組み込みの更新機能で正しいレコードを更新できません。(AutoGenerateColumns プロパティを true に設定することによって) 自動生成されたフィールド列を使用する場合、GridView コントロールは、DataKeyNames プロパティで指定された 1 つ以上のフィールドに対応する自動生成されたフィールド列が読み取り専用であるかどうかを自動的に確認します。
EditRowStyle プロパティを使用して、編集モードの行の外観を制御できます。通常、共通設定には、カスタムの背景色、前景色、およびフォントのプロパティが含まれます。
GridView コントロールには、行が更新されるときにカスタム アクションを実行するために使用できる複数のイベントが用意されています。使用できるイベントの一覧を次の表に示します。
| RowCancelingEdit | 行の Cancel ボタンがクリックされた場合に、GridView コントロールが編集モードをキャンセルする前に発生します。このイベントは、キャンセル操作を停止する場合によく使用されます。 |
| RowEditing | 行の Edit ボタンがクリックされた場合に、GridView コントロールが編集モードになる前に発生します。このイベントは、編集操作をキャンセルする場合によく使用されます。 |
| RowUpdated | 行の Update ボタンがクリックされた場合に、GridView コントロールが行を更新した後に発生します。このイベントは、更新操作の結果を確認する場合によく使用されます。 |
| RowUpdating | 行の Update ボタンがクリックされた場合に、GridView コントロールが行を更新する前に発生します。このイベントは、更新操作をキャンセルする場合によく使用されます。 |
使用例AutoGenerateEditButton プロパティを使用して、GridView コントロールの自動編集機能を有効にする方法を次のコード例に示します。
<%@ Page language="VB" %> <html> <body> <form runat="server"> <h3>GridView Edit Example</h3> <!-- 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" autogenerateeditbutton="true" datakeynames="CustomerID" 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)" deletecommand="Delete from Customers where CustomerID = @CustomerID" connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" runat="server"> </asp:sqldatasource> </form> </body> </html>
<%@ Page language="C#" %> <html> <body> <form runat="server"> <h3>GridView Edit Example</h3> <!-- 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" autogenerateeditbutton="true" datakeynames="CustomerID" 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)" deletecommand="Delete from Customers 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.AutoGenerateEditButton プロパティのページへのリンク
