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

ListView.ItemDataBound (Evento)

Actualización: noviembre 2007

Se produce cuando un elemento de datos de un control ListView se enlaza a datos.

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

public event EventHandler<ListViewItemEventArgs> ItemDataBound
/** @event */
public void add_ItemDataBound (EventHandler<ListViewItemEventArgs> value)
/** @event */
public void remove_ItemDataBound (EventHandler<ListViewItemEventArgs> value)

JScript no admite eventos.
<asp:ListView OnItemDataBound="EventHandler" />

Para poder representar el control ListView, cada elemento del control debe enlazarse a un registro del origen de datos. El evento ItemDataBound se produce cuando un elemento de datos se enlaza a los datos del control ListView. (Los objetos ListViewDataItem representan los elementos de datos.) Esto le permite ejecutar una rutina personalizada cada vez que se produce este evento, como modificar los valores de los datos enlazados al elemento.

Se pasa un objeto ListViewItemEventArgs al controlador de eventos, que le permite obtener acceso a las propiedades del elemento que se está enlazando. Para obtener acceso a un control específico del elemento, utilice el método FindControl del objeto ListViewItem incluido en la propiedad Item del objeto ListViewItemEventArgs. Puede determinar qué tipo de elemento se está enlazando (elemento de datos, elemento de inserción o elemento vacío) utilizando la propiedad ItemType.

Para obtener más información sobre el control de eventos, vea Utilizar eventos.

En el siguiente ejemplo, se muestra cómo utilizar el evento ItemDataBound.

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  protected void ContactsListView_ItemDataBound(object sender, ListViewItemEventArgs e)
  {
    if (e.Item.ItemType == ListViewItemType.DataItem)
    {
      // Display the e-mail address in italics.
      Label EmailAddressLabel = (Label)e.Item.FindControl("EmailAddressLabel");
      EmailAddressLabel.Font.Italic = true;
    }
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>ListView ItemDataBound Example</title>
  </head>
  <body style="font: 10pt Trebuchet MS">
    <form id="form1" runat="server">

      <h3>ListView ItemDataBound Example</h3>

      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource" 
        ConvertEmptyStringToNull="true"        
        OnItemDataBound="ContactsListView_ItemDataBound"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="680px" border="0">
            <tr style="background-color: #ADD8E6" runat="server">
                <th runat="server">First Name</th>
                <th runat="server">Last Name</th>
                <th runat="server">E-mail Address</th>
            </tr>
            <tr runat="server" id="itemPlaceholder" />
          </table>
          <asp:DataPager runat="server" ID="PeopleDataPager" PageSize="12">
            <Fields>
              <asp:NumericPagerField ButtonCount="10" /> 
            </Fields>
          </asp:DataPager>
        </LayoutTemplate>
        <ItemTemplate>
          <tr style="background-color: #CAEEFF" runat="server">
            <td>
              <asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
            </td>
            <td>
              <asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
            </td>
            <td>
              <asp:Label ID="EmailAddressLabel" runat="server" Text='<%#Eval("EmailAddress") %>' />
            </td>
          </tr>
        </ItemTemplate>
      </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 FirstName, LastName, EmailAddress FROM Person.Contact">
      </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: