CommandField.InsertText Property
Gets or sets the caption for the Insert button in a CommandField field.
Assembly: System.Web (in System.Web.dll)
Property Value
Type: System.StringThe caption for the Insert button in a CommandField. The default is "Insert".
When the ButtonType property of a CommandField field is set to ButtonType.Button or ButtonType.Link, use the InsertText property to specify the text to display for the Insert button.
Note |
|---|
As an alternative to displaying text for the Insert button, you can display an image by first setting the ButtonType property to ButtonType.Image and then setting the InsertImageUrl property. |
The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see LocalizableAttribute and ASP.NET Globalization and Localization.
The following code example demonstrates how to use the InsertText property to specify a custom caption for an Insert button displayed in a CommandField field of a DetailsView control.
<%@ Page language="VB" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" > <head runat="server"> <title>CommandField Example</title> </head> <body> <form id="form1" 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" inserttext="Save" newtext="Add New Customer" 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>
Available since 2.0
