Export (0) Print
Expand All

FormView.EditItemTemplate Property

Note: This property is new in the .NET Framework version 2.0.

Gets or sets the custom content for an item in edit mode.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

'Declaration
<TemplateContainerAttribute(GetType(FormView), BindingDirection.TwoWay)> _
Public Overridable Property EditItemTemplate As ITemplate
'Usage
Dim instance As FormView
Dim value As ITemplate

value = instance.EditItemTemplate

instance.EditItemTemplate = value
/** @property */
public ITemplate get_EditItemTemplate ()

/** @property */
public void set_EditItemTemplate (ITemplate value)

public function get EditItemTemplate () : ITemplate

public function set EditItemTemplate (value : ITemplate)

Property Value

A System.Web.UI.ITemplate that contains the custom content for the data row when the FormView control is in edit mode. The default value is null, which indicates that this property is not set.

The FormView control renders a different template for the data row based on the current mode of the control (specified by the CurrentMode property). The following table shows which template is used for each mode.

Mode

Template rendered

Edit

EditItemTemplate

Insert

InsertItemTemplate

Read-only

ItemTemplate

Use the EditItemTemplate property to define your own user interface (UI) for the data row when the FormView control is in edit mode. The edit item template usually contains the input controls for the user to update the values of an existing record, as well as command buttons to update the record and to cancel the update operation.

To specify the custom template, first place <EditItemTemplate> tags between the opening and closing tags of the FormView control. You can then list the contents of the template between the opening and closing <EditItemTemplate> tags. By using a two-way binding expression, you can associate a field with an input control. This allows the FormView control to automatically display the original field value in the associated input control in edit mode. When a record is updated, the FormView control automatically extracts the updated field value from the associated input control. For more information on two-way binding expressions, see Binding to Databases. To create command buttons that perform the built-in cancel and update operations, add a command button control to the template with its CommandName property set to one of the values listed in the following table.

Command button type

CommandName value

Cancel

"Cancel"

Update

"Update"

You can control the appearance of the item template by using the EditRowStyle property.

The following example demonstrates how to define a custom template for a data row in edit mode.


<%@ Page language="VB" %>

<html>
  <body>
    <form runat="server">
        
      <h3>FormView Example</h3>
                       
      <asp:formview id="EmployeeFormView"
        datasourceid="EmployeeSource"
        allowpaging="true"
        datakeynames="EmployeeID"
        emptydatatext="No employees found."  
        runat="server">
        
        <rowstyle backcolor="LightGreen"
          wrap="false"/>
        <editrowstyle backcolor="LightBlue"
          wrap="false"/>

        <itemtemplate>
          <table>
            <tr>
              <td rowspan="4">
                <asp:image id="EmployeeImage"
                  imageurl='<%# Eval("PhotoPath") %>'
                  alternatetext='<%# Eval("LastName") %>' 
                  runat="server"/>
              </td>
              <td colspan="2">
                  &nbsp; 
              </td>
            </tr>
            <tr>
              <td>
                <b>Name:</b>
              </td>
              <td>
                <%# Eval("FirstName") %> <%# Eval("LastName") %>
              </td>
            </tr>
            <tr>
              <td>
                <b>Title:</b>
              </td>
              <td>
                <%# Eval("Title") %>
              </td>
            </tr>
            <tr>
              <td colspan="2">
                <asp:linkbutton id="Edit"
                  text="Edit"
                  commandname="Edit"
                  runat="server"/> 
              </td>
            </tr>
          </table>       
        </itemtemplate>
        <edititemtemplate>
          <table>
            <tr>
              <td rowspan="4">
                <asp:image id="EmployeeEditImage"
                  imageurl='<%# Eval("PhotoPath") %>'
                  alternatetext='<%# Eval("LastName") %>' 
                  runat="server"/>
              </td>
              <td colspan="2">
                  &nbsp; 
              </td>
            </tr>
            <tr>
              <td>
                <b>Name:</b>
              </td>
              <td>
                <asp:textbox id="FirstNameUpdateTextBox"
                  text='<%# Bind("FirstName") %>'
                  runat="server"/>
                <asp:textbox id="LastNameUpdateTextBox"
                  text='<%# Bind("LastName") %>'
                  runat="server"/>
              </td>
            </tr>
            <tr>
              <td>
                <b>Title:</b>
              </td>
              <td>
                <asp:textbox id="TitleUpdateTextBox"
                  text='<%# Bind("Title") %>'
                  runat="server"/> 
              </td>
            </tr>
            <tr>
              <td colspan="2">
                <asp:linkbutton id="UpdateButton"
                  text="Update"
                  commandname="Update"
                  runat="server"/>
                <asp:linkbutton id="CancelButton"
                  text="Cancel"
                  commandname="Cancel"
                  runat="server"/> 
              </td>
            </tr>
          </table>       
        </edititemtemplate> 
                  
      </asp:formview>

      <!-- 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="EmployeeSource"
        selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]"
        updatecommand="Update [Employees] Set [LastName]=@LastName, [FirstName]=@FirstName, [Title]=@Title Where [EmployeeID]=@EmployeeID"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
            
    </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

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0

Community Additions

ADD
Show:
© 2014 Microsoft