Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Propiedad ListView.InsertItemTemplate

 

Publicado: octubre de 2016

Obtiene o establece el contenido personalizado de un elemento de inserción en el ListView control.

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

[BrowsableAttribute(false)]
[PersistenceModeAttribute(PersistenceMode.InnerProperty)]
[TemplateContainerAttribute(typeof(ListViewItem), BindingDirection.TwoWay)]
public virtual ITemplate InsertItemTemplate { get; set; }

Valor de propiedad

Type: System.Web.UI.ITemplate

Un objeto que contiene el contenido personalizado para el elemento de inserción en el ListView control. El valor predeterminado es null, lo que indica que esta propiedad no se estableció.

Utilice la InsertItemTemplate propiedad para definir una interfaz de usuario personalizada (UI) del elemento de inserción en el ListView control. Esta interfaz de usuario se representa al principio o al final de los elementos mostrados. Especificar dónde se representará la interfaz de usuario mediante el InsertItemPosition propiedad.

El InsertItemTemplate plantilla normalmente contiene controles de entrada para el usuario especificar los valores para un nuevo registro. También suele contener botones o hipervínculos para insertar el registro y cancelar la operación de inserción.

Para especificar la plantilla personalizada mediante declaración, agregue un InsertItemTemplate elemento dentro de la ListView elemento. A continuación, puede agregar el contenido de la plantilla para el InsertItemTemplate elemento. Puede asociar un campo a un control de entrada mediante una expresión de enlace bidireccional. Cuando se inserta un registro, el ListView control extrae automáticamente el valor del campo de control de entrada asociado. Para obtener más información, consulta Data-Binding Expressions Overview.

Para crear botones que realizan la cancelación integrada y las operaciones de inserción, agregue un control de botón a la plantilla. Establezca su CommandName propiedad en uno de los valores enumerados en la tabla siguiente.

Tipo de botón

Valor de CommandName

Cancelar

"Cancelar"

Insertar

"Insertar"

Puede controlar la posición del elemento insertado en el ListView control utilizando la InsertItemPosition propiedad.

En el ejemplo siguiente se muestra cómo definir una plantilla personalizada para el elemento de inserción de un ListView control. Este ejemplo de código forma parte de un ejemplo mayor proporcionado para el ItemInserted eventos.

System_CAPS_security Seguridad Nota

Este ejemplo tiene un cuadro de texto que acepta datos proporcionados por el usuario, lo que puede suponer una amenaza para la seguridad. De forma predeterminada, ASP.NET Web Pages valida que los datos proporcionados por el usuario no incluyen elementos HTML ni de script. Para obtener más información, consulta Script Exploits Overview.

<asp:ListView ID="ContactsListView" 
  DataSourceID="ContactsDataSource" 
  DataKeyNames="ContactID"
  OnItemInserted="ContactsListView_ItemInserted"  
  InsertItemPosition="LastItem"
  runat="server">
  <LayoutTemplate>
    <table cellpadding="2" border="1" runat="server" id="tblContacts" width="640px">
      <tr runat="server" id="itemPlaceholder" />
    </table>
    <asp:DataPager runat="server" ID="PeopleDataPager" 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 valign="top">
        <asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
        <asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
      </td>
      <td>&nbsp;
        <asp:Label ID="EmailLabel" runat="server" Text='<%#Eval("EmailAddress") %>' />
      </td>
    </tr>
  </ItemTemplate>
  <InsertItemTemplate>
    <tr style="background-color:#D3D3D3">
      <td valign="top">
        <asp:Label runat="server" ID="FirstNameLabel" 
          AssociatedControlID="FirstNameTextBox" Text="First Name"/>
        <asp:TextBox ID="FirstNameTextBox" runat="server" 
          Text='<%#Bind("FirstName") %>' /><br />
        <asp:Label runat="server" ID="LastNameLabel" 
          AssociatedControlID="LastNameTextBox" Text="Last Name" />
        <asp:TextBox ID="LastNameTextBox" runat="server" 
          Text='<%#Bind("LastName") %>' /><br />
        <asp:Label runat="server" ID="EmailLabel" 
          AssociatedControlID="EmailTextBox" Text="E-mail" />
        <asp:TextBox ID="EmailTextBox" runat="server" 
          Text='<%#Bind("EmailAddress") %>' />
      </td>
      <td>
        <asp:LinkButton ID="InsertButton" runat="server" 
          CommandName="Insert" Text="Insert" />
      </td>
    </tr>
  </InsertItemTemplate>
</asp:ListView>

.NET Framework
Disponible desde 3.5
Volver al principio
Mostrar: