CommandField.ShowInsertButton プロパティ
アセンブリ: System.Web (system.web.dll 内)
構文Dim instance As CommandField Dim value As Boolean value = instance.ShowInsertButton instance.ShowInsertButton = value
/** @property */ public boolean get_ShowInsertButton () /** @property */ public void set_ShowInsertButton (boolean value)
public function get ShowInsertButton () : boolean public function set ShowInsertButton (value : boolean)
CommandField に New ボタンを表示する場合は true。それ以外の場合は false。既定値は false です。
解説ShowInsertButton プロパティを使用して、CommandField フィールドに New ボタンを表示するかどうかを指定します。New ボタンは CommandField フィールドに 1 回だけ表示され、ユーザーはデータ ソースに新しいレコードを追加できます。
.gif) メモ |
|---|
| このプロパティは、DetailsView コントロールなど、挿入操作をサポートしたデータ バインド コントロールにのみ適用されます。 |
ユーザーが New ボタンをクリックすると、データ バインド コントロールに表示されたフィールドごとに入力コントロールが表示され、ユーザーは新しいレコードの値を入力できます。New ボタンは Insert ボタンと Cancel ボタンに置き換わり、CommandField フィールド内のその他のコマンド ボタンはすべて非表示になります。Insert ボタンをクリックするとデータ ソースにレコードが追加され、Cancel ボタンをクリックすると操作がキャンセルされます。
| メモ |
|---|
| データ バインド コントロールをデータ ソース コントロール (SqlDataSource コントロールなど) と組み合わせて使用すると、データ バインド コントロールはデータ ソース コントロールの機能を利用して、自動挿入機能を提供できます。その他のデータ ソースの場合、データ バインド コントロールの適切なイベント中に挿入操作を実行するためにルーチンを提供する必要があります。 |
CommandField フィールドの ButtonType プロパティが ButtonType.Button または ButtonType.Link に設定されている場合は、NewText プロパティを使用して、New ボタンに表示するテキストを指定します。または、最初に ButtonType プロパティを ButtonType.Image に設定してから NewImageUrl プロパティを設定することにより、イメージを表示できます。
使用例ShowInsertButton プロパティを使用して、DetailsView コントロールに New ボタンを表示し、ユーザーがデータ ソースに新しいレコードを追加できるようにする方法を次のコード例に示します。
<%@ Page language="VB" %> <html> <body> <form runat="server"> <h3>CommandField Example</h3> <asp:detailsview id="CustomersGridView" datasourceid="CustomersSqlDataSource" autogeneraterows="false" datakeynames="CustomerID" allowpaging="true" runat="server"> <fields> <asp:boundfield datafield="CustomerID" headertext="Customer ID" /> <asp:boundfield datafield="CompanyName" headertext="CompanyName"/> <asp:boundfield datafield="Address" headertext="Address"/> <asp:boundfield datafield="City" headertext="City"/> <asp:boundfield datafield="PostalCode" headertext="ZIP Code"/> <asp:boundfield datafield="Country" headertext="Country"/> <asp:commandfield showinsertbutton="true" showheader="true" headertext="Add Customer"/> </fields> </asp:detailsview> <!-- 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]" insertcommand="Insert Into [Customers]([CustomerID], [CompanyName], [City], [PostalCode], [Country]) Values (@CustomerID, @CompanyName, @City, @PostalCode, @Country)" connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" runat="server"> </asp:sqldatasource> </form> </body> </html>
<%@ Page language="C#" %> <html> <body> <form runat="server"> <h3>CommandField Example</h3> <asp:detailsview id="CustomersGridView" datasourceid="CustomersSqlDataSource" autogeneraterows="false" datakeynames="CustomerID" allowpaging="true" runat="server"> <fields> <asp:boundfield datafield="CustomerID" headertext="Customer ID" /> <asp:boundfield datafield="CompanyName" headertext="CompanyName"/> <asp:boundfield datafield="Address" headertext="Address"/> <asp:boundfield datafield="City" headertext="City"/> <asp:boundfield datafield="PostalCode" headertext="ZIP Code"/> <asp:boundfield datafield="Country" headertext="Country"/> <asp:commandfield showinsertbutton="true" showheader="true" headertext="Add Customer"/> </fields> </asp:detailsview> <!-- 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]" insertcommand="Insert Into [Customers]([CustomerID], [CompanyName], [City], [PostalCode], [Country]) Values (@CustomerID, @CompanyName, @City, @PostalCode, @Country)" 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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照CommandField クラス
CommandField メンバ
System.Web.UI.WebControls 名前空間
CommandField.InsertImageUrl プロパティ
CommandField.InsertText プロパティ
CommandField.NewImageUrl プロパティ
CommandField.NewText プロパティ
CommandField.ShowCancelButton プロパティ
CommandField.ShowDeleteButton プロパティ
CommandField.ShowEditButton プロパティ
ShowSelectButton
- CommandField.ShowInsertButton プロパティのページへのリンク
