Esta documentación está archivada y no tiene mantenimiento.

ListView.EditItemTemplate (Propiedad)

Actualización: noviembre 2007

Obtiene o establece el contenido personalizado del elemento en modo de edición.

Espacio de nombres:  System.Web.UI.WebControls
Ensamblado:  System.Web.Extensions (en System.Web.Extensions.dll)

[PersistenceModeAttribute(PersistenceMode.InnerProperty)]
[TemplateContainerAttribute(typeof(ListViewDataItem), BindingDirection.TwoWay)]
[BrowsableAttribute(false)]
public virtual ITemplate EditItemTemplate { get; set; }
/** @property */
/** @attribute PersistenceModeAttribute(PersistenceMode.InnerProperty) */
/** @attribute TemplateContainerAttribute(ListViewDataItem, BindingDirection.TwoWay) */
/** @attribute BrowsableAttribute(false) */
public ITemplate get_EditItemTemplate()
/** @property */
/** @attribute PersistenceModeAttribute(PersistenceMode.InnerProperty) */
/** @attribute TemplateContainerAttribute(ListViewDataItem, BindingDirection.TwoWay) */
/** @attribute BrowsableAttribute(false) */
public  void set_EditItemTemplate(ITemplate value)

public function get EditItemTemplate () : ITemplate
public function set EditItemTemplate (value : ITemplate)
<asp:ListView>
	<EditItemTemplate>ITemplate</EditItemTemplate>
</asp:ListView>

Valor de propiedad

Tipo: System.Web.UI.ITemplate
Objeto que incluye el contenido personalizado del elemento en modo de edición. El valor predeterminado es null, que indica que esta propiedad no está establecida.

Utilice la propiedad EditItemTemplate para definir una interfaz de usuario personalizada para el elemento en modo de edición. Normalmente, la plantilla EditItemTemplate contiene los controles de entrada que permiten al usuario actualizar los valores de un registro existente. También suele contener botones para actualizar el registro y cancelar la operación de actualización.

Para especificar la plantilla personalizada mediante declaración, agregue un elemento EditItemTemplate dentro del control ListView. A continuación, agregue contenido y controles para la plantilla al elemento EditItemTemplate. Puede asociar un campo a un control de entrada mediante una expresión de enlace bidireccional. Esto permite al control ListView mostrar automáticamente el valor de campo original en el control de entrada asociado para el elemento en modo de edición. Cuando se actualiza un registro, el control ListView puede extraer automáticamente el valor del campo actualizado del control de entrada asociado. Para obtener más información, vea Información general sobre las expresiones de enlace de datos.

Para crear botones que realicen las operaciones integradas de cancelación y actualización, agregue un control de botón a la plantilla. Establezca su propiedad CommandName en uno de los valores que se muestran en la tabla siguiente.

Tipo de botón

Valor de CommandName

Cancelar

"Cancel"

Actualizar

"Update"

En el ejemplo siguiente se muestra cómo definir una plantilla personalizada para el elemento en modo de edición.

Bb344889.alert_security(es-es,VS.90).gifNota de seguridad:

Este ejemplo tiene un cuadro de texto que acepta datos del usuario y puede suponer una amenaza para la seguridad. De forma predeterminada, las páginas web ASP.NET validan que los datos proporcionados por el usuario no incluyen elementos HTML ni de script. Para obtener más información, vea Información general sobre los ataques mediante secuencias de comandos.

<%@ Page language="C#" %>

<!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 id="Head1" runat="server">
    <title>ListView Templates Example</title>
  </head>
  <body>
    <form id="form1" runat="server">

      <h3>ListView Templates Example</h3>

      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource" 
        DataKeyNames="ContactID"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="640px" border="1" runat="server" id="tblProducts">
            <tr runat="server">
              <th runat="server">Action</th>
              <th runat="server">First Name</th>
              <th runat="server">Last Name</th>
            </tr>
            <tr runat="server" id="itemPlaceholder" />
          </table>
          <asp:DataPager runat="server" ID="ContactsDataPager" PageSize="12">
            <Fields>
              <asp:NextPreviousPagerField ShowFirstPageButton="true" ShowLastPageButton="true"
                FirstPageText="|&lt;&lt; " LastPageText=" &gt;&gt;|"
                NextPageText=" &gt; " PreviousPageText=" &lt; " />
            </Fields>
          </asp:DataPager>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:LinkButton ID="EditButton" runat="Server" Text="Edit" CommandName="Edit" />
            </td>
            <td>
              <asp:Label ID="FirstNameLabel" runat="Server" Text='<%#Eval("FirstName") %>' />
            </td>
            <td valign="top">
              <asp:Label ID="LastNameLabel" runat="Server" Text='<%#Eval("LastName") %>' />
            </td>
          </tr>
        </ItemTemplate>
        <EditItemTemplate>
          <tr style="background-color: #ADD8E6">
            <td>
              <asp:LinkButton ID="UpdateButton" runat="server" CommandName="Update" Text="Update" />&nbsp;
              <asp:LinkButton ID="CancelButton" runat="server" CommandName="Cancel" Text="Cancel" />
            </td>
            <td>
              <asp:TextBox ID="FirstNameTextBox" runat="server" Text='<%#Bind("FirstName") %>' 
                MaxLength="50" /><br />
            </td>
            <td>
              <asp:TextBox ID="LastNameTextBox" runat="server" Text='<%#Bind("LastName") %>' 
                MaxLength="50" /><br />
            </td>
          </tr>
        </EditItemTemplate>
      </asp:ListView>

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->
      <asp:SqlDataSource ID="ContactsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT [ContactID], [FirstName], [LastName] FROM Person.Contact"
        UpdateCommand="UPDATE Person.Contact
                       SET FirstName = @FirstName, LastName = @LastName
                       WHERE ContactID = @ContactID">
      </asp:SqlDataSource>

    </form>
  </body>
</html>


Windows Vista, Windows XP SP2, Windows Server 2003

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5
Mostrar: