ListView Clase

Definición

Muestra los valores de un origen de datos mediante plantillas definidas por el usuario.Displays the values of a data source by using user-defined templates. El control ListView permite a los usuarios seleccionar, ordenar, eliminar, modificar e insertar registros.The ListView control enables users to select, sort, delete, edit, and insert records.

public ref class ListView : System::Web::UI::WebControls::DataBoundControl, System::Web::UI::IDataKeysControl, System::Web::UI::INamingContainer, System::Web::UI::WebControls::IDataBoundListControl, System::Web::UI::WebControls::IPageableItemContainer, System::Web::UI::WebControls::IPersistedSelector
[System.Web.UI.ControlValueProperty("SelectedValue")]
[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.ListView), "ListView.ico")]
public class ListView : System.Web.UI.WebControls.DataBoundControl, System.Web.UI.IDataKeysControl, System.Web.UI.INamingContainer, System.Web.UI.WebControls.IDataBoundListControl, System.Web.UI.WebControls.IPageableItemContainer, System.Web.UI.WebControls.IPersistedSelector
[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.ListView), "ListView.bmp")]
[System.Web.UI.ControlValueProperty("SelectedValue")]
public class ListView : System.Web.UI.WebControls.DataBoundControl, System.Web.UI.IDataKeysControl, System.Web.UI.INamingContainer, System.Web.UI.WebControls.IDataBoundListControl, System.Web.UI.WebControls.IPageableItemContainer, System.Web.UI.WebControls.IPersistedSelector
type ListView = class
    inherit DataBoundControl
    interface INamingContainer
    interface IPageableItemContainer
    interface IPersistedSelector
    interface IDataKeysControl
    interface IDataBoundListControl
    interface IDataBoundControl
Public Class ListView
Inherits DataBoundControl
Implements IDataBoundListControl, IDataKeysControl, INamingContainer, IPageableItemContainer, IPersistedSelector
Herencia
Atributos
Implementaciones

Ejemplos

En el ejemplo siguiente se muestra cómo utilizar el control ListView para mostrar registros de una base de datos mediante una tabla HTML.The following example shows how to use the ListView control to display records from a database by using an HTML table. Los valores se recuperan mediante un control LinqDataSource.The values are retrieved by using a LinqDataSource control.

<%@ 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 Example</title>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>ListView Example</h3>
                       
      <asp:ListView ID="VendorsListView"
        DataSourceID="VendorsDataSource"
        DataKeyNames="VendorID"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="640px" border="1" ID="tbl1" runat="server">
            <tr runat="server" style="background-color: #98FB98">
              <th runat="server">ID</th>
              <th runat="server">Account Number</th>
              <th runat="server">Name</th>
              <th runat="server">Preferred Vendor</th>
            </tr>
            <tr runat="server" id="itemPlaceholder" />
          </table>
          <asp:DataPager ID="DataPager1" runat="server">
            <Fields>
              <asp:NumericPagerField />
            </Fields>
          </asp:DataPager>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="VendorIDLabel" runat="server" Text='<%# Eval("VendorID") %>' />
            </td>
            <td>
              <asp:Label ID="AccountNumberLabel" runat="server" Text='<%# Eval("AccountNumber") %>' />
            </td>
            <td>
              <asp:Label ID="NameLabel" runat="server" Text='<%# Eval("Name") %>' /></td>
            <td>
              <asp:CheckBox ID="PreferredCheckBox" runat="server" 
                Checked='<%# Eval("PreferredVendorStatus") %>' Enabled="False" />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>

      <!-- This example uses Microsoft SQL Server and connects   -->
      <!-- to the AdventureWorks sample database. Add a LINQ     -->
      <!-- to SQL class to the project to map to a table in      -->
      <!-- the database.                                         -->
      <asp:LinqDataSource ID="VendorsDataSource" runat="server" 
        ContextTypeName="AdventureWorksClassesDataContext" 
        Select="new (VendorID, AccountNumber, Name, PreferredVendorStatus)" 
        TableName="Vendors" Where="ActiveFlag == @ActiveFlag">
        <WhereParameters>
          <asp:Parameter DefaultValue="true" Name="ActiveFlag" Type="Boolean" />
        </WhereParameters>
      </asp:LinqDataSource>
      
    </form>
  </body>
</html>
<%@ 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 id="Head1" runat="server">
    <title>ListView Example</title>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>ListView Example</h3>
                       
      <asp:ListView ID="VendorsListView"
        DataSourceID="VendorsDataSource"
        DataKeyNames="VendorID"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="640px" border="1" ID="tbl1" runat="server">
            <tr runat="server" style="background-color: #98FB98">
              <th runat="server">ID</th>
              <th runat="server">Account Number</th>
              <th runat="server">Name</th>
              <th runat="server">Preferred Vendor</th>
            </tr>
            <tr runat="server" id="itemPlaceholder" />
          </table>
          <asp:DataPager ID="DataPager1" runat="server">
            <Fields>
              <asp:NumericPagerField />
            </Fields>
          </asp:DataPager>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="VendorIDLabel" runat="server" Text='<%# Eval("VendorID") %>' />
            </td>
            <td>
              <asp:Label ID="AccountNumberLabel" runat="server" Text='<%# Eval("AccountNumber") %>' />
            </td>
            <td>
              <asp:Label ID="NameLabel" runat="server" Text='<%# Eval("Name") %>' /></td>
            <td>
              <asp:CheckBox ID="PreferredCheckBox" runat="server" 
                Checked='<%# Eval("PreferredVendorStatus") %>' Enabled="False" />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>

      <!-- This example uses Microsoft SQL Server and connects   -->
      <!-- to the AdventureWorks sample database. Add a LINQ     -->
      <!-- to SQL class to the project to map to a table in      -->
      <!-- the database.                                         -->
      <asp:LinqDataSource ID="VendorsDataSource" runat="server" 
        ContextTypeName="AdventureWorksClassesDataContext" 
        Select="new (VendorID, AccountNumber, Name, PreferredVendorStatus)" 
        TableName="Vendors" Where="ActiveFlag == @ActiveFlag">
        <WhereParameters>
          <asp:Parameter DefaultValue="true" Name="ActiveFlag" Type="Boolean" />
        </WhereParameters>
      </asp:LinqDataSource>
      
    </form>
  </body>
</html>

En el ejemplo siguiente se muestra cómo usar el control ListView para mostrar valores en un diseño de flujo mediante el elemento div.The following example shows how to use the ListView control to display values in a flow layout by using the div element. Los valores se recuperan mediante un control SqlDataSource.The values are retrieved by using a SqlDataSource control.

<%@ 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 Flow Layout Example</title>
    <style type="text/css">
      .plainBox {
          font-family: Verdana, Arial, sans-serif;
          font-size: 11px;
          background: #ffffff;
          border:1px solid #336666;
          }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">

      <h3>ListView Flow Layout Example</h3>
      
      Select the color:
      <asp:DropDownList ID="ColorList" runat="server" 
        AutoPostBack="True" 
        DataSourceID="ColorDataSource" 
        DataTextField="Color" 
        DataValueField="Color">
      </asp:DropDownList><br /><br />
      
      <asp:ListView runat="server" ID="ProductListView"
        DataSourceID="ProductsDataSource"
        DataKeyNames="ProductID">
        <LayoutTemplate>
          <div runat="server" id="lstProducts">
            <div runat="server" id="itemPlaceholder" />
          </div>
          <asp:DataPager runat="server" PageSize="5" >
            <Fields>
              <asp:NextPreviousPagerField 
                ButtonType="Button"
                ShowFirstPageButton="True" 
                ShowLastPageButton="True" />
            </Fields>
          </asp:DataPager>
        </LayoutTemplate>
        <ItemTemplate>
          <asp:Image ID="ProductImage" runat="server"
            ImageUrl='<%# "~/images/thumbnails/" + Eval("ThumbnailPhotoFileName") %>' />	        
          <div class="plainBox" runat="server">
            <asp:HyperLink ID="ProductLink" runat="server" Text='<%# Eval("Name") %>' 
              NavigateUrl='<%# "ProductDetails.aspx?productID=" + Eval("ProductID") %>' />
            <br /><br />
            <b>Price:</b> 
            <asp:Label ID="PriceLabel" runat="server" Text='<%# Eval("ListPrice", "{0:c}")%>' /> <br />
          </div>
          <br />
        </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="ProductsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"            	        
        SelectCommand="SELECT P.ProductID, P.Name, P.Color, P.ListPrice, 
          PF.ThumbnailPhotoFileName, P.Size
          FROM Production.Product AS P 
          INNER JOIN Production.ProductProductPhoto AS PPF ON P.ProductID = PPF.ProductID 
          INNER JOIN Production.ProductPhoto AS PF ON PPF.ProductPhotoID = PF.ProductPhotoID
          WHERE P.Color = @Color" >
        <SelectParameters>
          <asp:ControlParameter ControlID="ColorList" Name="Color" 
            PropertyName="SelectedValue" />
        </SelectParameters>
      </asp:SqlDataSource>

      <asp:SqlDataSource ID="ColorDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>" 
        SelectCommand="SELECT DISTINCT Color FROM Production.Product">
      </asp:SqlDataSource>

    </form>
  </body>
</html>
<%@ 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 id="Head1" runat="server">
    <title>ListView Flow Layout Example</title>
    <style type="text/css">
      .plainBox {
          font-family: Verdana, Arial, sans-serif;
          font-size: 11px;
          background: #ffffff;
          border:1px solid #336666;
          }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">

      <h3>ListView Flow Layout Example</h3>
      
      Select the color:
      <asp:DropDownList ID="ColorList" runat="server" 
        AutoPostBack="True" 
        DataSourceID="ColorDataSource" 
        DataTextField="Color" 
        DataValueField="Color">
      </asp:DropDownList><br /><br />
      
      <asp:ListView runat="server" ID="ProductListView"
        DataSourceID="ProductsDataSource"
        DataKeyNames="ProductID">
        <LayoutTemplate>
          <div runat="server" id="lstProducts">
            <div runat="server" id="itemPlaceholder" />
          </div>
          <asp:DataPager ID="DataPager1" runat="server" PageSize="5" >
            <Fields>
              <asp:NextPreviousPagerField 
                ButtonType="Button"
                ShowFirstPageButton="True" 
                ShowLastPageButton="True" />
            </Fields>
          </asp:DataPager>
        </LayoutTemplate>
        <ItemTemplate>
          <asp:Image ID="ProductImage" runat="server"
            ImageUrl='<%# "~/images/thumbnails/" & Eval("ThumbnailPhotoFileName") %>' />	        
          <div class="plainBox" runat="server">
            <asp:HyperLink ID="ProductLink" runat="server" Text='<%# Eval("Name") %>' 
              NavigateUrl='<%# "ProductDetails.aspx?productID=" & Eval("ProductID") %>' />
            <br /><br />
            <b>Price:</b> 
            <asp:Label ID="PriceLabel" runat="server" Text='<%# Eval("ListPrice", "{0:c}")%>' /> <br />
          </div>
          <br />
        </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="ProductsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"            	        
        SelectCommand="SELECT P.ProductID, P.Name, P.Color, P.ListPrice, 
          PF.ThumbnailPhotoFileName, P.Size
          FROM Production.Product AS P 
          INNER JOIN Production.ProductProductPhoto AS PPF ON P.ProductID = PPF.ProductID 
          INNER JOIN Production.ProductPhoto AS PF ON PPF.ProductPhotoID = PF.ProductPhotoID
          WHERE P.Color = @Color" >
        <SelectParameters>
          <asp:ControlParameter ControlID="ColorList" Name="Color" 
            PropertyName="SelectedValue" />
        </SelectParameters>
      </asp:SqlDataSource>

      <asp:SqlDataSource ID="ColorDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>" 
        SelectCommand="SELECT DISTINCT Color FROM Production.Product">
      </asp:SqlDataSource>

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

En el ejemplo siguiente se muestra cómo utilizar el control ListView para insertar, eliminar y actualizar registros.The following example shows how to use the ListView control to insert, delete, and update records.

Importante

Este ejemplo tiene un cuadro de texto que acepta datos proporcionados por el usuario, lo que puede suponer una amenaza para la seguridad.This example has a text box that accepts user input, which is a potential security threat. De forma predeterminada, ASP.NET Web Pages valida que los datos proporcionados por el usuario no incluyen elementos HTML ni de script.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Para más información, consulte Información general sobre los ataques mediante scripts.For more information, see Script Exploits Overview.

<%@ 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 Example</title>
    <style type="text/css">
        .EditItem { background-color:#8FBC8F;}
        .SelectedItem {	background-color:#9ACD32; }
        .InsertItem { background-color:#FFFACD;}
    </style>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>ListView Example</h3>
      
      <h5>Departments</h5>

      <asp:ListView ID="DepartmentsListView" 
        DataSourceID="DepartmentsDataSource" 
        DataKeyNames="DepartmentID"
        ConvertEmptyStringToNull="true"
        InsertItemPosition="LastItem"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" runat="server" id="tblDepartments" width="640px" cellspacing="0">
            <tr runat="server" id="itemPlaceholder" />
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Button ID="SelectButton" runat="server" Text="Select" CommandName="Select" />
              <asp:Button ID="EditButton" runat="server" Text="Edit" CommandName="Edit" />
            </td>
            <td>
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("DepartmentID") %>' />
            </td>
            <td>
              <asp:Label ID="NameLabel" runat="server" Text='<%#Eval("Name") %>' />
            </td>
            <td>
              <asp:Label ID="GroupNameLabel" runat="server" Text='<%#Eval("GroupName") %>' />
            </td>
          </tr>
        </ItemTemplate>
        <SelectedItemTemplate>
          <tr class="SelectedItem" runat="server">
            <td>
              <asp:Button ID="DeleteButton" runat="server" Text="Delete" CommandName="Delete" />
              <asp:Button ID="EditButton" runat="server" Text="Edit" CommandName="Edit" />
            </td>
            <td>
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("DepartmentID") %>' />
            </td>
            <td>
              <asp:Label ID="NameLabel" runat="server" Text='<%#Eval("Name") %>' />
            </td>
            <td>
              <asp:Label ID="GroupNameLabel" runat="server" Text='<%#Eval("GroupName") %>' />
            </td>
          </tr>
        </SelectedItemTemplate>
        <EditItemTemplate>
          <tr class="EditItem">
            <td>
              <asp:Button ID="UpdateButton" runat="server" CommandName="Update" Text="Update" />
              <asp:Button ID="CancelButton" runat="server" CommandName="Cancel" Text="Cancel" />
            </td>
            <td>
              <b>ID</b><br />
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("DepartmentID") %>' />
            </td>
            <td>
              <asp:Label runat="server" ID="NameLabel" AssociatedControlID="NameTextBox" 
                Text="Name" Font-Bold="true"/><br />
              <asp:TextBox ID="NameTextBox" runat="server" Text='<%#Bind("Name") %>' />
            </td>
            <td>
              <asp:Label runat="server" ID="GroupNameLabel" AssociatedControlID="GroupNameTextBox" 
                Text="Group Name" Font-Bold="true" /><br />
              <asp:TextBox ID="GroupNameTextBox" runat="server" 
                Width="200px"
                Text='<%#Bind("GroupName") %>' />
              <br />
            </td>
          </tr>
        </EditItemTemplate>
        <InsertItemTemplate>
          <tr class="InsertItem">
            <td colspan="2">
              <asp:Button ID="InsertButton" runat="server" CommandName="Insert" Text="Insert" />
              <asp:Button ID="CancelButton" runat="server" CommandName="Cancel" Text="Cancel" />
            </td>
            <td>
              <asp:Label runat="server" ID="NameLabel" AssociatedControlID="NameTextBox" 
                Text="Name" Font-Bold="true"/><br />
              <asp:TextBox ID="NameTextBox" runat="server" Text='<%#Bind("Name") %>' /><br />
            </td>
            <td>
              <asp:Label runat="server" ID="GroupNameLabel" AssociatedControlID="GroupNameTextBox" 
                Text="Group Name" Font-Bold="true" /><br />                
              <asp:TextBox ID="GroupNameTextBox" runat="server" Text='<%#Bind("GroupName") %>' />
            </td>
          </tr>
        </InsertItemTemplate>
      </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="DepartmentsDataSource" runat="server" 
            ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
            SelectCommand="SELECT DepartmentID, Name, GroupName FROM HumanResources.Department"
            UpdateCommand="UPDATE HumanResources.Department 
                SET Name = @Name, GroupName = @GroupName WHERE (DepartmentID = @DepartmentID)"            
            DeleteCommand="DELETE FROM HumanResources.Department 
                WHERE (DepartmentID = @DepartmentID)" 
            InsertCommand="INSERT INTO HumanResources.Department(Name, GroupName) 
                VALUES (@Name, @GroupName)">
      </asp:SqlDataSource>
      
    </form>
  </body>
</html>
<%@ 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 id="Head1" runat="server">
    <title>ListView Example</title>
    <style type="text/css">
        .EditItem { background-color:#8FBC8F;}
        .SelectedItem {	background-color:#9ACD32; }
        .InsertItem { background-color:#FFFACD;}
    </style>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>ListView Example</h3>
      
      <h5>Departments</h5>

      <asp:ListView ID="DepartmentsListView" 
        DataSourceID="DepartmentsDataSource" 
        DataKeyNames="DepartmentID"
        ConvertEmptyStringToNull="true"
        InsertItemPosition="LastItem"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" runat="server" id="tblDepartments" width="640px" cellspacing="0">
            <tr runat="server" id="itemPlaceholder" />
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Button ID="SelectButton" runat="server" Text="Select" CommandName="Select" />
              <asp:Button ID="EditButton" runat="server" Text="Edit" CommandName="Edit" />
            </td>
            <td>
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("DepartmentID") %>' />
            </td>
            <td>
              <asp:Label ID="NameLabel" runat="server" Text='<%#Eval("Name") %>' />
            </td>
            <td>
              <asp:Label ID="GroupNameLabel" runat="server" Text='<%#Eval("GroupName") %>' />
            </td>
          </tr>
        </ItemTemplate>
        <SelectedItemTemplate>
          <tr class="SelectedItem" runat="server">
            <td>
              <asp:Button ID="DeleteButton" runat="server" Text="Delete" CommandName="Delete" />
              <asp:Button ID="EditButton" runat="server" Text="Edit" CommandName="Edit" />
            </td>
            <td>
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("DepartmentID") %>' />
            </td>
            <td>
              <asp:Label ID="NameLabel" runat="server" Text='<%#Eval("Name") %>' />
            </td>
            <td>
              <asp:Label ID="GroupNameLabel" runat="server" Text='<%#Eval("GroupName") %>' />
            </td>
          </tr>
        </SelectedItemTemplate>
        <EditItemTemplate>
          <tr class="EditItem">
            <td>
              <asp:Button ID="UpdateButton" runat="server" CommandName="Update" Text="Update" />
              <asp:Button ID="CancelButton" runat="server" CommandName="Cancel" Text="Cancel" />
            </td>
            <td>
              <b>ID</b><br />
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("DepartmentID") %>' />
            </td>
            <td>
              <asp:Label runat="server" ID="NameLabel" AssociatedControlID="NameTextBox" 
                Text="Name" Font-Bold="true"/><br />
              <asp:TextBox ID="NameTextBox" runat="server" Text='<%#Bind("Name") %>' />
            </td>
            <td>
              <asp:Label runat="server" ID="GroupNameLabel" AssociatedControlID="GroupNameTextBox" 
                Text="Group Name" Font-Bold="true" /><br />
              <asp:TextBox ID="GroupNameTextBox" runat="server" 
                Width="200px"
                Text='<%#Bind("GroupName") %>' />
              <br />
            </td>
          </tr>
        </EditItemTemplate>
        <InsertItemTemplate>
          <tr class="InsertItem">
            <td colspan="2">
              <asp:Button ID="InsertButton" runat="server" CommandName="Insert" Text="Insert" />
              <asp:Button ID="CancelButton" runat="server" CommandName="Cancel" Text="Cancel" />
            </td>
            <td>
              <asp:Label runat="server" ID="NameLabel" AssociatedControlID="NameTextBox" 
                Text="Name" Font-Bold="true"/><br />
              <asp:TextBox ID="NameTextBox" runat="server" Text='<%#Bind("Name") %>' /><br />
            </td>
            <td>
              <asp:Label runat="server" ID="GroupNameLabel" AssociatedControlID="GroupNameTextBox" 
                Text="Group Name" Font-Bold="true" /><br />                
              <asp:TextBox ID="GroupNameTextBox" runat="server" Text='<%#Bind("GroupName") %>' />
            </td>
          </tr>
        </InsertItemTemplate>
      </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="DepartmentsDataSource" runat="server" 
            ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
            SelectCommand="SELECT DepartmentID, Name, GroupName FROM HumanResources.Department"
            UpdateCommand="UPDATE HumanResources.Department 
                SET Name = @Name, GroupName = @GroupName WHERE (DepartmentID = @DepartmentID)"            
            DeleteCommand="DELETE FROM HumanResources.Department 
                WHERE (DepartmentID = @DepartmentID)" 
            InsertCommand="INSERT INTO HumanResources.Department(Name, GroupName) 
                VALUES (@Name, @GroupName)">
      </asp:SqlDataSource>
      
    </form>
  </body>
</html>

Comentarios

En este tema:In this topic:

IntroducciónIntroduction

El control ListView se utiliza para mostrar los valores de un origen de datos.The ListView control is used to display the values from a data source. Es similar al control GridView, salvo que muestra los datos mediante plantillas definidas por el usuario en lugar de campos de fila.It resembles the GridView control, except that it displays data by using user-defined templates instead of row fields. La creación de sus propias plantillas le proporciona más flexibilidad para controlar el modo en que se muestran los datos.Creating your own templates gives you more flexibility in controlling how the data is displayed.

Un proyecto de Visual Studio con código fuente está disponible para acompañar este tema: Descargar.A Visual Studio project with source code is available to accompany this topic: Download.

El control ListView admite las siguientes características:The ListView control supports the following features:

  • Compatibilidad con el enlace a controles de origen de datos como SqlDataSource, LinqDataSourcey ObjectDataSource.Support for binding to data source controls such as SqlDataSource, LinqDataSource, and ObjectDataSource.

  • Apariencia personalizable a través de plantillas y estilos definidos por el usuario.Customizable appearance through user-defined templates and styles.

  • Funcionalidades de ordenación integradas.Built-in sorting capabilities.

  • Capacidades integradas de actualización y eliminación.Built-in update and delete capabilities.

  • Funcionalidades de inserción integradas.Built-in insert capabilities.

  • Compatibilidad con funciones de paginación mediante el uso de un control de DataPager.Support for paging capabilities by using a DataPager control.

  • Capacidades de selección de elementos integradas.Built-in item selection capabilities.

  • Acceso mediante programación al modelo de objetos de ListView para establecer propiedades dinámicamente, controlar eventos, etc.Programmatic access to the ListView object model to dynamically set properties, handle events, and so on.

  • Varios campos de clave.Multiple key fields.

Para obtener información sobre otros controles enlazados a datos que están disponibles en ASP.NET, vea controles de servidor Web enlazados a datos.To learn about other data-bound controls that are available in ASP.NET, see Data-Bound Web Server Controls.

PlantillasTemplates

Para que el control de ListView muestre contenido, debe crear plantillas para diferentes partes del control.In order for the ListView control to display content, you must create templates for different parts of the control. Se necesita ItemTemplate.The ItemTemplate is required. Todas las demás plantillas son opcionales.All other templates are optional. La propiedad LayoutTemplate no es necesaria.The LayoutTemplate property is not required.

Sin embargo, debe crear una plantilla para el modo en el que está configurado el control.However, you must create a template for the mode in which the control is configured. Por ejemplo, un control de ListView que admite la inserción de registros debe tener una plantilla InsertItemTemplate definida.For example, a ListView control that supports inserting records must have an InsertItemTemplate template defined. En la tabla siguiente se enumeran las plantillas que se pueden crear para el control de ListView.The following table lists the templates that you can create for the ListView control.

Tipo de plantillaTemplate type DescripciónDescription
LayoutTemplate La plantilla raíz que define un objeto contenedor, como un elemento table, divo span, que contendrá el contenido definido en la plantilla ItemTemplate o GroupTemplate.The root template that defines a container object, such as a table, div, or span element, that will contain the content defined in the ItemTemplate or GroupTemplate template. También puede contener un objeto DataPager.It might also contain a DataPager object.
ItemTemplate Define el contenido enlazado a datos que se va a mostrar para los elementos individuales.Defines the data-bound content to display for individual items.
ItemSeparatorTemplate Define el contenido que se va a representar entre elementos individuales.Defines the content to render between individual items.
GroupTemplate Define un objeto contenedor, como una fila de tabla (tr), divo span elemento, que contendrá el contenido definido en las plantillas ItemTemplate y EmptyItemTemplate.Defines a container object, such as a table row (tr), div, or span element, that will contain the content defined in the ItemTemplate and EmptyItemTemplate templates. La propiedad GroupItemCount especifica el número de elementos que se muestran en un grupo.The number of items that are displayed in a group is specified by the GroupItemCount property.
GroupSeparatorTemplate Define el contenido que se va a representar entre grupos de elementos.Defines the content to render between groups of items.
EmptyItemTemplate Define el contenido que se va a representar para un elemento vacío cuando se utiliza una plantilla de GroupTemplate.Defines the content to render for an empty item when a GroupTemplate template is used. Por ejemplo, si la propiedad GroupItemCount está establecida en 5 y el número total de elementos devueltos desde el origen de datos es 8, el último grupo de datos mostrado por el control ListView contendrá tres elementos como se especifica en la plantilla ItemTemplate y dos elementos como se especifica en la plantilla EmptyItemTemplate.For example, if the GroupItemCount property is set to 5, and the total number of items returned from the data source is 8, the last group of data displayed by the ListView control will contain three items as specified by the ItemTemplate template, and two items as specified by the EmptyItemTemplate template.
EmptyDataTemplate Define el contenido que se va a representar si el origen de datos no devuelve datos.Defines the content to render if the data source returns no data.
SelectedItemTemplate Define el contenido que se va a representar para el elemento de datos seleccionado para diferenciar el elemento seleccionado de otros elementos.Defines the content to render for the selected data item to differentiate the selected item from other items.
AlternatingItemTemplate Define el contenido que se va a representar para los elementos alternos con el fin de facilitar la distinción entre elementos consecutivos.Defines the content to render for alternating items to make it easier to distinguish between consecutive items.
EditItemTemplate Define el contenido que se representará cuando se edite un elemento.Defines the content to render when an item is being edited. La plantilla de EditItemTemplate se representa en lugar de la plantilla de ItemTemplate para el elemento de datos que se está editando.The EditItemTemplate template is rendered in place of the ItemTemplate template for the data item that is being edited.
InsertItemTemplate Define el contenido que se va a representar para insertar un elemento.Defines the content to render to insert an item. La plantilla de InsertItemTemplate se representa en lugar de una plantilla de ItemTemplate al principio o al final de los elementos que se muestran en el control de ListView.The InsertItemTemplate template is rendered in place of an ItemTemplate template at either the start or at the end of the items that are displayed by the ListView control. Puede especificar dónde se representa la plantilla de InsertItemTemplate mediante la propiedad InsertItemPosition del control ListView.You can specify where the InsertItemTemplate template is rendered by using the InsertItemPosition property of the ListView control.

Para mostrar el valor de un campo en una plantilla como ItemTemplate, se usa una expresión de enlace de datos.To display the value of a field in a template such as ItemTemplate, you use a data-binding expression. Para obtener más información sobre las expresiones de enlace de datos, vea información general sobre expresiones de enlace de datos.For more information about data-binding expressions, see Data-Binding Expressions Overview.

Para enlazar los controles de entrada de las plantillas EditItemTemplate y InsertItemTemplate a los campos de un origen de datos, puede usar expresiones de enlace bidireccionales.To bind input controls in the EditItemTemplate and InsertItemTemplate templates to fields of a data source, you can use two-way binding expressions. Esto permite que el control de ListView Extraiga automáticamente los valores del control de entrada para una operación de actualización o inserción.This enables the ListView control to automatically extract the values of the input control for an update or insert operation. Las expresiones de enlace bidireccionales también permiten que los controles de entrada de un EditItemTemplate muestren automáticamente los valores de campo originales.Two-way binding expressions also enable input controls in an EditItemTemplate to automatically display the original field values. Para obtener más información sobre las expresiones de enlace bidireccionales, vea enlazar a bases de datos.For more information about two-way binding expressions, see Binding to Databases.

Enlazar a un origen de datosBinding to a Data Source

Puede enlazar el control de ListView a un control de origen de datos (como el control de SqlDataSource o ObjectDataSource) o a cualquier colección de orígenes de datos que implemente la interfaz de System.Collections.IEnumerable, como System.Data.DataView, System.Collections.ArrayList, System.Collections.Generic.List<T>u otros tipos de colección.You can bind the ListView control to a data source control (such as the SqlDataSource control or ObjectDataSource control) or to any data source collection that implements the System.Collections.IEnumerable interface, such as System.Data.DataView, System.Collections.ArrayList, System.Collections.Generic.List<T>, or other collection types. Use uno de los métodos siguientes para enlazar el control ListView al tipo de origen de datos adecuado:Use one of the following methods to bind the ListView control to the appropriate data source type:

  • Para enlazar a un control de origen de datos, establezca la propiedad DataSourceID del control ListView en el valor ID del control de origen de datos.To bind to a data source control, set the DataSourceID property of the ListView control to the ID value of the data source control. El control ListView se enlaza automáticamente al control de origen de datos especificado y puede aprovechar las capacidades del control de origen de datos para realizar operaciones de ordenación, inserción, actualización, eliminación y paginación.The ListView control automatically binds to the specified data source control and can take advantage of the data source control's capabilities to perform sorting, inserting, updating, deleting, and paging functionality. Este es el método preferido para enlazar a datos.This is the preferred method to bind to data.

  • Para enlazar a un origen de datos que implementa la interfaz System.Collections.IEnumerable, establezca mediante programación la propiedad DataSource del control ListView en el origen de datos y, a continuación, llame al método DataBind.To bind to a data source that implements the System.Collections.IEnumerable interface, programmatically set the DataSource property of the ListView control to the data source, and then call the DataBind method. Cuando se utiliza esta técnica, el control ListView no proporciona funcionalidad integrada de ordenación, actualización, eliminación y paginación.When you use this technique, the ListView control does not provide built-in sorting, updating, deleting, and paging functionality. Debe proporcionar esta funcionalidad mediante el evento adecuado.You must provide this functionality by using the appropriate event.

Para obtener más información sobre el enlace de datos, consulte ASP.net Data Access Content Map.For more information about data binding, see ASP.NET Data Access Content Map.

Nota

El control ListView se puede usar para mostrar los datos proporcionados por el usuario, que pueden incluir scripts de cliente malintencionados.The ListView control can be used to display user input, which might include malicious client script. Compruebe la información que se envía desde un cliente para el script ejecutable, las instrucciones SQL u otro código antes de mostrarlo en la aplicación.Check any information that is sent from a client for executable script, SQL statements, or other code before you display it in the application. Se recomienda encarecidamente que los valores estén codificados en HTML siempre que sea posible antes de que se muestren en este control.We strongly recommend that values be HTML-encoded whenever possible before they are displayed in this control. ASP.NET proporciona una característica de validación de solicitudes de entrada para ayudar a bloquear el script y HTML en los datos proporcionados por el usuario.ASP.NET provides an input request validation feature to help block script and HTML in user input. También puede usar los controles de servidor de validación para comprobar los datos proporcionados por el usuario.You can also use validation server controls to check user input. Para obtener más información, vea Introducción a los controles de validación.For more information, see Introduction to the Validation Controls.

Operaciones de datosData Operations

Cuando el control de ListView se enlaza a un control de origen de datos, el control ListView puede aprovechar las capacidades del control de origen de datos y proporcionar la funcionalidad de ordenación, inserción, actualización y eliminación automática.When the ListView control is bound to a data source control, the ListView control can take advantage of the data source control's capabilities and provide automatic sort, insert, update, and delete functionality.

Nota

El control ListView puede proporcionar compatibilidad para ordenar, insertar, actualizar y eliminar con otros tipos de orígenes de datos.The ListView control can provide support for sorting, inserting, updating, and deleting with other types of data sources. Sin embargo, para implementar estas operaciones, debe crear código en un controlador de eventos adecuado.However, in order to implement these operations, you must create code in an appropriate event handler.

Dado que el control ListView utiliza plantillas, no proporciona una manera de generar automáticamente botones para realizar operaciones de actualización, eliminación, inserción, ordenación o selección.Because the ListView control uses templates, it does not provide a way to automatically generate buttons to perform update, delete, insert, sort, or select operations. Debe incluir manualmente estos botones en la plantilla adecuada.You must manually include these buttons in the appropriate template. El control ListView reconoce ciertos botones cuya propiedad CommandName está establecida en un valor específico.The ListView control recognizes certain buttons whose CommandName property is set to a specific value. En la tabla siguiente se muestran los botones que reconoce el control ListView y sus funciones.The following table lists the buttons that the ListView control recognizes and their functions.

BotónButton Valor de CommandNameCommandName value DescripciónDescription
CancelarCancel Ha"Cancel" Cancela una operación de edición o inserción.Cancels an edit or insert operation. Inicia el evento ItemCanceling.Raises the ItemCanceling event.
EliminarDelete “Eliminar”"Delete" Elimina el registro actual del origen de datos.Deletes the current record from the data source. Genera los eventos ItemDeleted y ItemDeleting.Raises the ItemDeleted and ItemDeleting events.
SeleccionarSelect No"Select" Establece la propiedad SelectedIndex en el valor de la propiedad DisplayIndex para el elemento.Sets the SelectedIndex property to the DisplayIndex property value for the item. Representa el SelectedItemTemplate plantilla para el elemento.Renders the SelectedItemTemplate template for the item. Genera los eventos SelectedIndexChanging y SelectedIndexChanged.Raises the SelectedIndexChanging and SelectedIndexChanged events.
EditarEdit Editar"Edit" Coloca el elemento en modo de edición.Puts the item in edit mode. Representa el EditItemTemplate plantilla para el elemento.Renders the EditItemTemplate template for the item. Inicia el evento ItemEditing.Raises the ItemEditing event.
InsertarInsert Introducir"Insert" Inserta los valores enlazados de la plantilla de InsertItemTemplate en el origen de datos.Inserts the bound values from the InsertItemTemplate template into the data source. Genera los eventos ItemInserting y ItemInserted.Raises the ItemInserting and ItemInserted events.
ActualizarUpdate Update"Update" Actualiza el registro actual en el origen de datos con los valores enlazados de la plantilla EditItemTemplate.Updates the current record in the data source with the bound values from the EditItemTemplate template. Genera los eventos ItemUpdating y ItemUpdated.Raises the ItemUpdating and ItemUpdated events.
SortSort Clasificación"Sort" Ordena las columnas mostradas en la propiedad CommandArgument del botón.Sorts the columns listed in the CommandArgument property of the button. Genera los eventos Sorting y Sorted.Raises the Sorting and Sorted events.

A diferencia del botón Eliminar (que elimina inmediatamente el elemento de datos actual), cuando se hace clic en el botón Editar, el control ListView muestra el elemento actual en modo de edición.Unlike the Delete button (which deletes the current data item immediately), when the Edit button is clicked, the ListView control displays the current item in edit mode. En el modo de edición, el contenido incluido en la propiedad EditItemTemplate se muestra para el elemento de datos actual.In edit mode, the content that is contained in the EditItemTemplate property is displayed for the current data item. Normalmente, en la plantilla editar elemento, el botón Editar se sustituye por un botón actualizar y cancelar.Typically, in the edit item template, the Edit button is replaced with an Update and a Cancel button. Los controles de entrada adecuados para el tipo de datos del campo (por ejemplo, un control TextBox o CheckBox) también muestran normalmente el valor de un campo para que un usuario lo modifique.Input controls that are appropriate for the field's data type (such as a TextBox or CheckBox control) also usually display a field's value for a user to modify. Al hacer clic en el botón actualizar, se actualiza el registro del origen de datos y, al hacer clic en el botón Cancelar, se cancela la operación de edición.Clicking the Update button updates the record in the data source, and clicking the Cancel button cancels the edit operation.

La funcionalidad de inserción se habilita cuando la propiedad InsertItemPosition está establecida en FirstItem o LastItem.The insert functionality is enabled when the InsertItemPosition property is set to FirstItem or LastItem. Esta propiedad define dónde se representa la plantilla de InsertItemTemplate para el elemento de inserción.This property defines where the InsertItemTemplate template is rendered for the insert item. La plantilla insertar elemento normalmente incluye un botón Insertar y un botón Cancelar, y se muestran controles de entrada vacíos para que los usuarios escriban los valores del nuevo registro.The insert item template typically includes an Insert and a Cancel button, and empty input controls are displayed for users to enter the values for the new record. Al hacer clic en el botón Insertar, se inserta el registro en el origen de datos y, al hacer clic en el botón Cancelar, se borran todos los campos.Clicking the Insert button inserts the record in the data source, and clicking the Cancel button clears all the fields.

OrdenaciónSorting

El control ListView permite a los usuarios ordenar los elementos haciendo clic en el botón de ordenación.The ListView control enables users to sort the items by clicking the Sort button. La funcionalidad de ordenación se define en la propiedad CommandArgument del botón que contiene las columnas que se van a ordenar.Sort functionality is defined in the CommandArgument property of the button that contains the columns to be sorted.

PaginaciónPaging

En lugar de Mostrar todos los registros del origen de datos al mismo tiempo, el control ListView puede dividir los registros en páginas.Instead of displaying all the records from the data source at the same time, the ListView control can break the records into pages. Para habilitar la paginación, asocie un control DataPager con el control ListView.To enable paging, associate a DataPager control with the ListView control. A continuación, inserte un control DataPager dentro de la plantilla LayoutTemplate.Then insert a DataPager control inside the LayoutTemplate template. Como alternativa, si el control de DataPager está fuera del control ListView, establezca la propiedad PagedControlID en el ID del control ListView.Alternatively, if the DataPager control is outside the ListView control, set the PagedControlID property to the ID of the ListView control.

EventosEvents

En la tabla siguiente se enumeran los eventos admitidos por el control ListView.The following table lists the events that are supported by the ListView control.

EventoEvent DescripciónDescription
ItemCanceling Se produce cuando se hace clic en el botón Cancelar (un botón con su propiedad CommandName establecida en "Cancelar"), pero antes de que el control ListView cancele la operación de inserción o edición.Occurs when the Cancel button (a button with its CommandName property set to "Cancel") is clicked, but before the ListView control cancels the insert or edit operation. Este evento suele usarse para detener la operación de cancelación.This event is often used to stop the cancel operation.
ItemCommand Se desencadena cuando se hace clic en un botón del control ListView.Occurs when a button is clicked in the ListView control. Este evento suele usarse para realizar una tarea personalizada cuando se hace clic en un botón del control.This event is often used to perform a custom task when a button is clicked in the control.
ItemCreated Se produce cuando se crea un nuevo elemento en el control ListView.Occurs when a new item is created in the ListView control. Este evento se usa a menudo para modificar el contenido de un elemento cuando se crea el elemento.This event is often used to modify the content of an item when the item is created.
ItemDataBound Se produce cuando un elemento de datos se enlaza a los datos del control ListView.Occurs when a data item is bound to data in the ListView control. Este evento se usa a menudo para modificar el contenido de un elemento cuando el elemento está enlazado a datos.This event is often used to modify the content of an item when the item is bound to data.
ItemDeleted Se produce cuando se hace clic en un botón Eliminar (un botón con su propiedad CommandName establecida en "eliminar") o se llama al método DeleteItem, después de que el control ListView elimina el registro del origen de datos.Occurs when a Delete button (a button with its CommandName property set to "Delete") is clicked or the DeleteItem method is called, after the ListView control deletes the record from the data source. Este evento se usa a menudo para comprobar los resultados de la operación de eliminación.This event is often used to check the results of the delete operation.
ItemDeleting Se produce cuando se hace clic en un botón Eliminar (un botón con su propiedad CommandName establecida en "eliminar") o se llama al método DeleteItem, pero antes de que el control ListView elimine el registro del origen de datos.Occurs when a Delete button (a button with its CommandName property set to "Delete") is clicked or the DeleteItem method is called, but before the ListView control deletes the record from the data source. Este evento se usa a menudo para confirmar o cancelar la operación de eliminación.This event is often used to confirm or cancel the delete operation.
ItemEditing Se produce cuando se hace clic en un botón Editar (un botón con su propiedad CommandName establecida en "Editar"), pero antes de que el control ListView entre en el modo de edición.Occurs when an Edit button (a button with its CommandName property set to "Edit") is clicked, but before the ListView control enters edit mode. Este evento suele usarse para cancelar la operación de edición.This event is often used to cancel the editing operation.
ItemInserted Se produce cuando se hace clic en un botón Insertar (un botón con su propiedad CommandName establecida en "Insert") o se llama al método InsertNewItem, después de que el control ListView Inserte el nuevo registro del origen de datos.Occurs when an Insert button (a button with its CommandName property set to "Insert") is clicked or the InsertNewItem method is called, after the ListView control inserts the new record from the data source. Este evento se usa a menudo para comprobar los resultados de la operación de inserción.This event is often used to check the results of the insert operation.
ItemInserting Se produce cuando se hace clic en un botón Insertar (un botón con su propiedad CommandName establecida en "Insertar") o se llama al método InsertNewItem, pero antes de que el control ListView Inserte el registro.Occurs when an Insert button (a button with its CommandName property set to "Insert") is clicked or the InsertNewItem method is called, but before the ListView control inserts the record. Este evento se usa a menudo para cancelar la operación de inserción o cambiar o validar los valores del nuevo elemento.This event is often used to cancel the insert operation or change or validate the values of the new item.
ItemUpdated Se produce cuando se hace clic en un botón Actualizar (un botón con su propiedad CommandName establecida en "actualizar") o se llama al método UpdateItem, después de que el control ListView actualiza el registro.Occurs when an Update button (a button with its CommandName property set to "Update") is clicked or the UpdateItem method is called, after the ListView control updates the record. Este evento se usa a menudo para comprobar los resultados de la operación de actualización.This event is often used to check the results of the update operation.
ItemUpdating Se produce cuando se hace clic en un botón Actualizar (un botón con su propiedad CommandName establecida en "actualizar") o se llama al método UpdateItem, pero antes de que el control ListView actualice el registro.Occurs when an Update button (a button with its CommandName property set to "Update") is clicked or the UpdateItem method is called, but before the ListView control updates the record. Este evento se usa a menudo para cancelar la operación de actualización o cambiar o validar los valores del elemento editado.This event is often used to cancel the updating operation or change or validate the values of the edited item.
LayoutCreated Se produce cuando la plantilla LayoutTemplate se crea en un control ListView.Occurs when the LayoutTemplate template is created in a ListView control. Este evento suele usarse para realizar una tarea después de crear la plantilla.This event is often used to perform a task after the template is created.
PagePropertiesChanged Se produce cuando cambian las propiedades de página, después de que el control ListView establezca los nuevos valores.Occurs when the page properties change, after the ListView control sets the new values.
PagePropertiesChanging Se produce cuando cambian las propiedades de la página de datos, pero antes de que el control ListView establezca los nuevos valores.Occurs when the data-page properties change, but before the ListView control sets the new values.
SelectedIndexChanged Se produce cuando se hace clic en un botón Seleccionar (un botón con su propiedad CommandName establecida en "Select"), una vez que el control ListView controla la operación Select.Occurs when a Select button (a button with its CommandName property set to "Select") is clicked, after the ListView control handles the select operation. Este evento suele usarse para realizar una tarea personalizada después de seleccionar un elemento en el control.This event is often used to perform a custom task after an item is selected in the control.
SelectedIndexChanging Se produce cuando se hace clic en un botón Seleccionar (un botón con su propiedad CommandName establecida en "seleccionar"), pero antes de que el control ListView controle la operación de selección.Occurs when a Select button (a button with its CommandName property set to "Select") is clicked, but before the ListView control handles the select operation. Este evento suele usarse para cancelar la operación de selección.This event is often used to cancel the select operation.
Sorted Se produce cuando se hace clic en un botón de ordenación (un botón con su propiedad CommandName establecida en "ordenar") o se llama al método Sort, después de que el control ListView controla la operación de ordenación.Occurs when a Sort button (a button with its CommandName property set to "Sort") is clicked or the Sort method is called, after the ListView control handles the sort operation. Este evento se usa normalmente para realizar una tarea personalizada cuando un usuario hace clic en un botón de ordenación y los datos se han ordenado.This event is typically used to perform a custom task after a user clicks a Sort button and the data has been sorted.
Sorting Se produce cuando se hace clic en un botón de ordenación (un botón con su propiedad CommandName establecida en "ordenar") o se llama al método Sort, pero antes de que el control ListView administre la operación de ordenación.Occurs when a Sort button (a button with its CommandName property set to "Sort") is clicked or the Sort method is called, but before the ListView control handles the sort operation. Este evento suele usarse para cancelar la operación de ordenación o para realizar una rutina de ordenación personalizada.This event is often used to cancel the sorting operation or to perform a custom sorting routine.

Sintaxis declarativaDeclarative Syntax

<asp:ListView
    ConvertEmptyStringToNull="True|False"
    DataKeyNames="string"
    DataMember="string"
    DataSource="string"
    DataSourceID="string"
    EditIndex="integer"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    GroupPlaceholderID="string"
    GroupItemCount="integer"
    ID="string"
    InsertItemPosition="None|FirstItem|LastItem"
    ItemPlaceholderID="string"
    OnDataBinding="DataBinding event handler"
    OnDataBound="DataBound event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnItemCanceling="ItemCanceling event handler"
    OnItemCommand="ItemCommand event handler"
    OnItemCreated="ItemCreated event handler"
    OnItemDataBound="ItemDataBound event handler"
    OnItemDeleted="ItemDeleted event handler"
    OnItemDeleting="ItemDeleting event handler"
    OnItemEditing="ItemEditing event handler"
    OnItemInserted="ItemInserted event handler"
    OnItemInserting="ItemInserting event handler"
    OnItemUpdated="ItemUpdated event handler"
    OnItemUpdating="ItemUpdating event handler"
    OnLayoutCreated="LayoutCreated event handler"
    OnLoad="Load event handler"
    OnPagePropertiesChanged="PagePropertiesChanged event handler"
    OnPagePropertiesChanging="PagePropertiesChanging event handler"
    OnPreRender="PreRender event handler"
    OnSelectedIndexChanged="SelectedIndexChanged event handler"
    OnSelectedIndexChanging="SelectedIndexChanging event handler"
    OnSorted="Sorted event handler"
    OnSorting="Sorting event handler"
    OnUnload="Unload event handler"
    runat="server"
    SelectedIndex="integer"
    SkinID="string"
    Style="string"
    Visible="True|False"
>
        <AlternatingItemTemplate>
            <!-- child controls -->
        </AlternatingItemTemplate>
        <EditItemTemplate>
            <!-- child controls -->
        </EditItemTemplate>
        <EmptyDataTemplate>
            <!-- child controls -->
        </EmptyDataTemplate>
        <EmptyItemTemplate>
            <!-- child controls -->
        </EmptyItemTemplate>
        <GroupSeparatorTemplate>
            <!-- child controls -->
        </GroupSeparatorTemplate>
        <GroupTemplate>
            <!-- child controls -->
        </GroupTemplate>
        <InsertItemTemplate>
            <!-- child controls -->
        </InsertItemTemplate>
        <ItemSeparatorTemplate>
            <!-- child controls -->
        </ItemSeparatorTemplate>
        <ItemTemplate>
            <!-- child controls -->
        </ItemTemplate>
        <LayoutTemplate>
                <!-- child controls -->
        </LayoutTemplate>
        <SelectedItemTemplate>
            <!-- child controls -->
        </SelectedItemTemplate>
</asp:ListView>

Constructores

ListView()

Inicializa una nueva instancia de la clase ListView.Initializes a new instance of the ListView class.

Propiedades

AccessKey

Reemplaza la propiedad AccessKey.Overrides the AccessKey property. El control ListView no admite el establecimiento de esta propiedad.Setting this property is not supported by the ListView control.

Adapter

Obtiene el adaptador específico del explorador para el control.Gets the browser-specific adapter for the control.

(Heredado de Control)
AlternatingItemTemplate

Obtiene o establece el contenido personalizado para el elemento de datos alterno de un control ListView.Gets or sets the custom content for the alternating data item in a ListView control.

AppRelativeTemplateSourceDirectory

Obtiene o establece el directorio virtual relativo a la aplicación del objeto Page o el objeto UserControl que contiene este control.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Heredado de Control)
Attributes

Obtiene la colección de atributos arbitrarios (sólo para su representación) que no corresponden a propiedades del control.Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control.

(Heredado de WebControl)
BackColor

Reemplaza la propiedad BackColor.Overrides the BackColor property. El control ListView no admite el establecimiento de esta propiedad.Setting this property is not supported by the ListView control.

BindingContainer

Obtiene el control que contiene el enlace de datos de este control.Gets the control that contains this control's data binding.

(Heredado de Control)
BorderColor

Reemplaza la propiedad BorderColor.Overrides the BorderColor property. El control ListView no admite el establecimiento de esta propiedad.Setting this property is not supported by the ListView control.

BorderStyle

Reemplaza la propiedad BorderStyle.Overrides the BorderStyle property. El control ListView no admite el establecimiento de esta propiedad.Setting this property is not supported by the ListView control.

BorderWidth

Reemplaza la propiedad BorderWidth.Overrides the BorderWidth property. El control ListView no admite el establecimiento de esta propiedad.Setting this property is not supported by the ListView control.

ChildControlsCreated

Obtiene un valor que indica si se han creado controles secundarios del control de servidor.Gets a value that indicates whether the server control's child controls have been created.

(Heredado de Control)
ClientID

Obtiene el id. de control para marcado HTML que se genera por ASP.NET.Gets the control ID for HTML markup that is generated by ASP.NET.

(Heredado de Control)
ClientIDMode

Obtiene o establece el algoritmo que se utiliza para generar el valor de la propiedad ClientID.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Heredado de Control)
ClientIDRowSuffix

Obtiene o establece el nombre del campo de datos cuyo valor se utiliza para identificar de manera única cada fila de datos de un control ListView cuando la propiedad ClientIDMode está establecida en Predictable.Gets or sets the name of the data field whose value is used to uniquely identify each data row of a ListView control when the ClientIDMode property is set to Predictable.

ClientIDRowSuffixDataKeys

Obtiene los valores de datos que se usan para identificar de manera única cada instancia de un control enlazado a datos cuando ASP.NET genera el valor de ClientID.Gets the data values that are used to uniquely identify each instance of a data-bound control when ASP.NET generates the ClientID value.

ClientIDSeparator

Obtiene un valor de carácter que representa el carácter separado utilizado en la propiedad ClientID.Gets a character value representing the separator character used in the ClientID property.

(Heredado de Control)
Context

Obtiene el objeto HttpContext asociado al control de servidor para la solicitud Web actual.Gets the HttpContext object associated with the server control for the current Web request.

(Heredado de Control)
Controls

Obtiene un objeto ControlCollection que representa los controles secundarios del control ListView.Gets a ControlCollection object that represents the child controls of the ListView control.

ControlStyle

Obtiene el estilo del control de servidor web.Gets the style of the Web server control. Esta propiedad la usan principalmente los programadores de controles.This property is used primarily by control developers.

(Heredado de WebControl)
ControlStyleCreated

Obtiene un valor que indica si se ha creado un objeto Style para la propiedad ControlStyle.Gets a value indicating whether a Style object has been created for the ControlStyle property. Esta propiedad la usan principalmente los programadores de controles.This property is primarily used by control developers.

(Heredado de WebControl)
ConvertEmptyStringToNull

Obtiene o establece un valor que indica si los valores de cadena vacía ("") se convierten automáticamente en valores nulos cuando se actualiza el campo de datos en el origen de datos.Gets or sets a value that indicates whether empty string values ("") are automatically converted to null values when the data field is updated in the data source.

CssClass

Reemplaza la propiedad CssClass.Overrides the CssClass property. El control ListView no admite el establecimiento de esta propiedad.Setting this property is not supported by the ListView control.

DataItemContainer

Obtiene una referencia al contenedor de nomenclatura si este implementa IDataItemContainer.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Heredado de Control)
DataKeyNames

Obtiene o establece una matriz que contiene los nombres de los campos de clave principal de los elementos mostrados en un control ListView.Gets or sets an array that contains the names of the primary key fields for the items displayed in a ListView control.

DataKeys

Obtiene una colección de objetos DataKey que representan el valor de clave de los datos para cada elemento de un control ListView.Gets a collection of DataKey objects that represent the data-key value for each item in a ListView control.

DataKeysContainer

Obtiene una referencia al contenedor de nomenclatura si este implementa IDataKeysControl.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Heredado de Control)
DataMember

Obtiene o establece el nombre de la lista de datos a la que se enlaza el control enlazado a datos, en los casos en que el origen de datos contiene más de una lista distinta de elementos de datos.Gets or sets the name of the list of data that the data-bound control binds to, in cases where the data source contains more than one distinct list of data items.

(Heredado de DataBoundControl)
DataSource

Obtiene o establece el objeto del que el control enlazado a datos recupera su lista de elementos de datos.Gets or sets the object from which the data-bound control retrieves its list of data items.

(Heredado de BaseDataBoundControl)
DataSourceID

Obtiene o establece el identificador del control desde el que el control enlazado a datos recupera su lista de elementos de datos.Gets or sets the ID of the control from which the data-bound control retrieves its list of data items.

(Heredado de DataBoundControl)
DataSourceObject

Obtiene un objeto que implementa la interfaz IDataSource, que proporciona acceso al contenido de datos del objeto.Gets an object that implements the IDataSource interface, which provides access to the object's data content.

(Heredado de DataBoundControl)
DeleteMethod

Obtiene o establece el nombre de método al que se va a llamar para eliminar datos.Gets or sets the name of the method to call in order to delete data.

DesignMode

Obtiene un valor que indica si se está utilizando un control en una superficie de diseño.Gets a value indicating whether a control is being used on a design surface.

(Heredado de Control)
EditIndex

Obtiene o establece el índice del elemento que va a editarse.Gets or sets the index of the item being edited.

EditItem

Obtiene el elemento que está en modo de edición en un control ListView.Gets the item that is in edit mode in a ListView control.

EditItemTemplate

Obtiene o establece el contenido personalizado del elemento en modo de edición.Gets or sets the custom content for the item in edit mode.

EmptyDataTemplate

Obtiene o establece el contenido definido por el usuario para la plantilla vacía que se representa cuando un control ListView se enlaza a un origen de datos que no contiene registros.Gets or sets the user-defined content for the empty template that is rendered when a ListView control is bound to a data source that does not contain any records.

EmptyItemTemplate

Obtiene o establece el contenido definido por el usuario para el elemento vacío que se representa en un control ListView cuando no hay ningún elemento de datos más que mostrar en la última fila de la página de datos actual.Gets or sets the user-defined content for the empty item that is rendered in a ListView control when there are no more data items to display in the last row of the current data page.

Enabled

Obtiene o establece un valor que indica si el control de servidor web está habilitado.Gets or sets a value indicating whether the Web server control is enabled.

(Heredado de WebControl)
EnableModelValidation

Obtiene o establece un valor que indica si un control de validación controlará las excepciones que se produzcan durante las operaciones de inserción o actualización.Gets or sets a value that indicates whether a validator control will handle exceptions that occur during insert or update operations.

EnablePersistedSelection

Obtiene o establece un valor que indica si se conserva la selección de filas cuando un usuario se desplaza por los datos en un control enlazado a datos.Gets or sets a value that indicates whether row selection persists when a user pages through data in a data-bound control.

EnableTheming

Obtiene o establece un valor que indica si los temas se aplican a este control.Gets or sets a value indicating whether themes apply to this control.

(Heredado de WebControl)
EnableViewState

Obtiene o establece un valor que indica si el control de servidor conserva su estado de vista, así como el estado de vista de los controles secundarios que contiene, al cliente solicitante.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(Heredado de Control)
Events

Obtiene una lista de delegados de controladores de eventos del control.Gets a list of event handler delegates for the control. Esta propiedad es de solo lectura.This property is read-only.

(Heredado de Control)
Font

Reemplaza la propiedad Font.Overrides the Font property. El control ListView no es compatible con esta propiedad.This property is not supported by the ListView control.

ForeColor

Reemplaza la propiedad ForeColor.Overrides the ForeColor property. El control ListView no admite el establecimiento de esta propiedad.Setting this property is not supported by the ListView control.

GroupItemCount

Obtiene o establece el número de elementos que se van a mostrar por grupo en un control ListView.Gets or sets the number of items to display per group in a ListView control.

GroupPlaceholderID

Obtiene o establece el identificador del marcador de posición de grupo en un control ListView.Gets or sets the ID for the group placeholder in a ListView control.

GroupSeparatorTemplate

Obtiene o establece el contenido definido por el usuario para el separador entre los grupos de un control ListView.Gets or sets the user-defined content for the separator between groups in a ListView control.

GroupTemplate

Obtiene o establece el contenido definido por el usuario para el contenedor de grupo de un control ListView.Gets or sets the user-defined content for the group container in a ListView control.

HasAttributes

Obtiene un valor que indica si el control tiene establecido algún atributo.Gets a value indicating whether the control has attributes set.

(Heredado de WebControl)
HasChildViewState

Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen guardada alguna configuración del estado de vista.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Heredado de Control)
Height

Reemplaza la propiedad Height.Overrides the Height property. El control ListView no admite el establecimiento de esta propiedad.Setting this property is not supported by the ListView control.

ID

Obtiene o establece el identificador de programación asignado al control de servidor.Gets or sets the programmatic identifier assigned to the server control.

(Heredado de Control)
IdSeparator

Obtiene el carácter utilizado para separar los identificadores de control.Gets the character used to separate control identifiers.

(Heredado de Control)
Initialized

Obtiene un valor que indica si el control enlazado a datos está inicializado.Gets a value indicating whether the data-bound control has been initialized.

(Heredado de BaseDataBoundControl)
InsertItem

Obtiene el elemento insertado de un control ListView.Gets the insert item of a ListView control.

InsertItemPosition

Obtiene o establece la ubicación de la plantilla de InsertItemTemplate cuando se representa como parte del control ListView.Gets or sets the location of the InsertItemTemplate template when it is rendered as part of the ListView control.

InsertItemTemplate

Obtiene o establece el contenido personalizado de un elemento de inserción en el control ListView.Gets or sets the custom content for an insert item in the ListView control.

InsertMethod

Obtiene o establece el nombre de método al que se va a llamar para insertar datos.Gets or sets the name of the method to call in order to insert data.

IsBoundUsingDataSourceID

Obtiene un valor que indica si la propiedad DataSourceID está establecida.Gets a value indicating whether the DataSourceID property is set.

(Heredado de BaseDataBoundControl)
IsChildControlStateCleared

Obtiene un valor que indica si los controles que se encuentran en este control tienen estado de control.Gets a value indicating whether controls contained within this control have control state.

(Heredado de Control)
IsDataBindingAutomatic

Obtiene un valor que indica si el enlace de datos es automático.Gets a value that indicates whether data binding is automatic.

(Heredado de BaseDataBoundControl)
IsEnabled

Obtiene un valor que indica si está habilitado el control.Gets a value indicating whether the control is enabled.

(Heredado de WebControl)
IsTrackingViewState

Obtiene un valor que indica si el control de servidor está guardando los cambios realizados en su estado de vista.Gets a value that indicates whether the server control is saving changes to its view state.

(Heredado de Control)
IsUsingModelBinders

Obtiene un valor que indica si se usa el enlace de modelo.Gets a value that indicates whether model binding is in use.

IsViewStateEnabled

Obtiene un valor que indica si el estado de vista está habilitado para este control.Gets a value indicating whether view state is enabled for this control.

(Heredado de Control)
ItemPlaceholderID

Obtiene o establece el identificador del marcador de posición de elemento en un control ListView.Gets or sets the ID for the item placeholder in a ListView control.

Items

Obtiene una colección de objetos ListViewDataItem que representan los elementos de datos de la página de datos actual en un control ListView.Gets a collection of ListViewDataItem objects that represent the data items of the current page of data in a ListView control.

ItemSeparatorTemplate

Obtiene o establece el contenido personalizado para el separador entre los elementos de un control ListView.Gets or sets the custom content for the separator between the items in a ListView control.

ItemTemplate

Obtiene o establece el contenido personalizado del elemento de datos de un control ListView.Gets or sets the custom content for the data item in a ListView control.

ItemType

Obtiene o establece el nombre del tipo de elemento de datos para el enlace de datos fuertemente tipado.Gets or sets the name of the data item type for strongly typed data binding.

(Heredado de DataBoundControl)
LayoutTemplate

Obtiene o establece el contenido personalizado para el contenedor raíz en un control ListView.Gets or sets the custom content for the root container in a ListView control.

LoadViewStateByID

Obtiene un valor que indica si el control participa en la carga de su estado de vista mediante ID en lugar de índice.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(Heredado de Control)
MaximumRows

Obtiene el número máximo de elementos que deben mostrarse en una sola página del control ListView.Gets the maximum number of items to display on a single page of the ListView control.

NamingContainer

Obtiene una referencia al contenedor de nomenclatura del control de servidor, que crea un espacio de nombres único para diferenciar los distintos controles de servidor que tienen el mismo valor para la propiedad ID.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(Heredado de Control)
Page

Obtiene una referencia a la instancia Page que contiene el control de servidor.Gets a reference to the Page instance that contains the server control.

(Heredado de Control)
Parent

Obtiene una referencia al control principal del control de servidor en la jerarquía de controles de página.Gets a reference to the server control's parent control in the page control hierarchy.

(Heredado de Control)
RenderingCompatibility

Obtiene o establece un valor que especifica la versión de ASP.NET compatible con los elementos HTML representados.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Heredado de Control)
RequiresDataBinding

Obtiene o establece un valor que indica si se debe llamar al método DataBind().Gets or sets a value indicating whether the DataBind() method should be called.

(Heredado de BaseDataBoundControl)
SelectArguments

Obtiene un objeto DataSourceSelectArguments que utiliza el control enlazado a datos al recuperar los datos de un control de origen de datos.Gets a DataSourceSelectArguments object that the data-bound control uses when retrieving data from a data source control.

(Heredado de DataBoundControl)
SelectedDataKey

Obtiene el valor de la clave de datos para el elemento seleccionado en un control ListView.Gets the data-key value for the selected item in a ListView control.

SelectedIndex

Obtiene o establece el índice del elemento seleccionado en un control ListView.Gets or sets the index of the selected item in a ListView control.

SelectedItemTemplate

Obtiene o establece el contenido personalizado para el elemento seleccionado en un control ListView.Gets or sets the custom content for the selected item in a ListView control.

SelectedPersistedDataKey

Obtiene o establece el valor de la clave de datos del elemento seleccionado almacenado en un control enlazado a datos.Gets or sets the data-key value for the persisted selected item in a data-bound control.

SelectedValue

Obtiene el valor de la clave de datos del elemento seleccionado en un control ListView.Gets the data-key value of the selected item in a ListView control.

SelectMethod

Nombre del método al que se va a llamar para leer datos.The name of the method to call in order to read data.

(Heredado de DataBoundControl)
Site

Obtiene información sobre el contenedor en que se encuentra el control actual cuando se representa en una superficie de diseño.Gets information about the container that hosts the current control when rendered on a design surface.

(Heredado de Control)
SkinID

Obtiene o establece la máscara que se aplica al control.Gets or sets the skin to apply to the control.

(Heredado de WebControl)
SortDirection

Obtiene la dirección de ordenación del campo o de los campos que se están ordenando.Gets the sort direction of the field or fields that are being sorted.

SortExpression

Obtiene la expresión de ordenación asociada al campo o los campos que se están ordenando.Gets the sort expression that is associated with the field or fields that are being sorted.

StartRowIndex

Obtiene el índice del primer registro que se muestra en una página de datos en el control ListView.Gets the index of the first record that is displayed on a page of data in the ListView control.

Style

Obtiene una colección de atributos de texto que se representan como atributo de estilo en la etiqueta externa del control de servidor web.Gets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control.

(Heredado de WebControl)
SupportsDisabledAttribute

Obtiene un valor que indica si el control debe establecer en "disabled" el atributo disabled del elemento HTML representado cuando el valor de la propiedad IsEnabled del control es false.Gets a value that indicates whether the control should set the disabled attribute of the rendered HTML element to "disabled" when the control's IsEnabled property is false.

(Heredado de BaseDataBoundControl)
TabIndex

Reemplaza la propiedad TabIndex.Overrides the TabIndex property. El control ListView no admite el establecimiento de esta propiedad.Setting this property is not supported by the ListView control.

TagKey

Obtiene el valor HtmlTextWriterTag correspondiente al control de servidor web.Gets the HtmlTextWriterTag value that corresponds to this Web server control. Esta propiedad la usan principalmente los programadores de controles.This property is used primarily by control developers.

(Heredado de WebControl)
TagName

Obtiene el nombre de la etiqueta del control.Gets the name of the control tag. Esta propiedad la usan principalmente los programadores de controles.This property is used primarily by control developers.

(Heredado de WebControl)
TemplateControl

Obtiene o establece una referencia a la plantilla que contiene este control.Gets or sets a reference to the template that contains this control.

(Heredado de Control)
TemplateSourceDirectory

Obtiene el directorio virtual de Page o UserControl que contiene el control de servidor actual.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Heredado de Control)
ToolTip

Reemplaza la propiedad ToolTip.Overrides the ToolTip property. El control ListView no admite el establecimiento de esta propiedad.Setting this property is not supported by the ListView control.

UniqueID

Obtiene el identificador único calificado jerárquicamente para el control de servidor.Gets the unique, hierarchically qualified identifier for the server control.

(Heredado de Control)
UpdateMethod

Obtiene o establece el nombre de método al que se va a llamar para actualizar datos.Gets or sets the name of the method to call in order to update data.

ValidateRequestMode

Obtiene o establece un valor que indica si el control comprueba la entrada del cliente desde el explorador para valores potencialmente peligrosos.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Heredado de Control)
ViewState

Obtiene un diccionario con información de estado que le permite guardar y restaurar el estado de vista de un control de servidor en las distintas solicitudes de la misma página.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(Heredado de Control)
ViewStateIgnoresCase

Obtiene un valor que indica si el objeto StateBag no distingue mayúsculas de minúsculas.Gets a value that indicates whether the StateBag object is case-insensitive.

(Heredado de Control)
ViewStateMode

Obtiene o establece el modo del estado de vista de este control.Gets or sets the view-state mode of this control.

(Heredado de Control)
Visible

Obtiene o establece un valor que indica si un control de servidor se representa como interfaz de usuario en la página.Gets or sets a value that indicates whether a server control is rendered as UI on the page.

(Heredado de Control)
Width

Reemplaza la propiedad Width.Overrides the Width property. El control ListView no admite el establecimiento de esta propiedad.Setting this property is not supported by the ListView control.

Métodos

AddAttributesToRender(HtmlTextWriter)

Agrega atributos y estilos HTML que se deben representar en el HtmlTextWriterTag especificado.Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriterTag. Este método lo usan principalmente los desarrolladores de controles.This method is used primarily by control developers.

(Heredado de WebControl)
AddControlToContainer(Control, Control, Int32)

Agrega el control especificado al contenedor especificado.Adds the specified control to the specified container.

AddedControl(Control, Int32)

Se llama después de agregar un control secundario a la colección Controls del objeto Control.Called after a child control is added to the Controls collection of the Control object.

(Heredado de Control)
AddParsedSubObject(Object)

Notifica al control de servidor que se analizó un elemento, ya sea XML o HTML, y agrega el elemento al objeto ControlCollection del control del servidor.Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(Heredado de Control)
ApplyStyle(Style)

Copia en el control Web todos los elementos no vacíos del estilo especificado, sobrescribiendo los elementos de estilo existentes del mismo.Copies any nonblank elements of the specified style to the Web control, overwriting any existing style elements of the control. Este método lo usan principalmente los programadores de controles.This method is primarily used by control developers.

(Heredado de WebControl)
ApplyStyleSheetSkin(Page)

Aplica al control las propiedades de estilo definidas en la hoja de estilos de la página.Applies the style properties defined in the page style sheet to the control.

(Heredado de Control)
BeginRenderTracing(TextWriter, Object)

Comienza el seguimiento en tiempo de diseño de los datos de representación.Begins design-time tracing of rendering data.

(Heredado de Control)
BuildProfileTree(String, Boolean)

Recopila información sobre el control de servidor y la pasa a la propiedad Trace para que se muestre cuando está habilitada la traza de la página.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Heredado de Control)
ClearCachedClientID()

Establece en ClientID el valor de null almacenado en caché.Sets the cached ClientID value to null.

(Heredado de Control)
ClearChildControlState()

Elimina la información sobre el estado de control de los controles secundarios del control de servidor.Deletes the control-state information for the server control's child controls.

(Heredado de Control)
ClearChildState()

Elimina la información sobre el estado de vista y el estado de control de los controles secundarios del control de servidor.Deletes the view-state and control-state information for all the server control's child controls.

(Heredado de Control)
ClearChildViewState()

Elimina la información sobre el estado de vista de todos los controles secundarios del control de servidor.Deletes the view-state information for all the server control's child controls.

(Heredado de Control)
ClearEffectiveClientIDMode()

Establece la propiedad ClientIDMode de la instancia del control actual y de cualquier control secundario en Inherit.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Heredado de Control)
ConfirmInitState()

Establece el estado inicializado del control enlazado a datos.Sets the initialized state of the data-bound control.

(Heredado de BaseDataBoundControl)
CopyBaseAttributes(WebControl)

Copia las propiedades no encapsuladas por el objeto Style del control de servidor web especificado al control de servidor web desde el que se efectúa la llamada al método.Copies the properties not encapsulated by the Style object from the specified Web server control to the Web server control that this method is called from. Este método lo usan principalmente los desarrolladores de controles.This method is used primarily by control developers.

(Heredado de WebControl)
CreateChildControls()

Crea la jerarquía de controles que se utiliza para procesar el control ListView, basándose en los valores que se almacenan en estado de vista.Creates the control hierarchy that is used to render the ListView control, based on the values that are stored in view state.

CreateChildControls(IEnumerable, Boolean)

Crea la jerarquía de controles que se utiliza para representar el control ListView mediante el origen de datos especificado.Creates the control hierarchy that is used to render the ListView control by using the specified data source.

CreateControlCollection()

Crea un nuevo objeto ControlCollection que contendrá los controles secundarios (de literal y servidor) del control de servidor.Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.

(Heredado de Control)
CreateControlStyle()

Crea el estilo predeterminado para el control.Creates the default style for the control.

CreateDataItem(Int32, Int32)

Crea un elemento de datos en el control ListView.Creates a data item in the ListView control.

CreateDataSourceSelectArguments()

Crea el objeto DataSourceSelectArguments que contiene los argumentos que se pasan al origen de datos.Creates the DataSourceSelectArguments object that contains the arguments that are passed to the data source.

CreateEmptyDataItem()

Crea la plantilla EmptyDataTemplate en el control ListView.Creates the EmptyDataTemplate template in the ListView control.

CreateEmptyItem()

Crea un elemento vacío en el control ListView.Creates an empty item in the ListView control.

CreateInsertItem()

Crea un elemento de inserción en el control ListView.Creates an insert item in the ListView control.

CreateItem(ListViewItemType)

Crea un objeto ListViewItem con el tipo especificado.Creates a ListViewItem object with the specified type.

CreateItemsInGroups(ListViewPagedDataSource, Boolean, InsertItemPosition, ArrayList)

Crea la jerarquía de controles ListView en grupos.Creates the ListView control hierarchy in groups.

CreateItemsWithoutGroups(ListViewPagedDataSource, Boolean, InsertItemPosition, ArrayList)

Crea la jerarquía de controles ListView sin grupos.Creates the ListView control hierarchy without groups.

CreateLayoutTemplate()

Crea el contenedor raíz del control ListView.Creates the root container in the ListView control.

CreateSuffixArrayList(ListViewPagedDataSource, ArrayList)

Crea una matriz de sufijos para ASP.NET que se va a utilizar cuando se genere el valor de ClientID.Creates an array of suffixes for ASP.NET to use when it generates the ClientID value.

DataBind()

Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios.Binds a data source to the invoked server control and all its child controls.

(Heredado de BaseDataBoundControl)
DataBind(Boolean)

Enlaza un origen de datos al control de servidor que se ha invocado y a todos sus controles secundarios con una opción para generar el evento DataBinding.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Heredado de Control)
DataBindChildren()

Enlaza un origen de datos a los controles secundarios del control de servidor.Binds a data source to the server control's child controls.

(Heredado de Control)
DeleteItem(Int32)

Elimina el registro en el índice especificado del origen de datos.Deletes the record at the specified index from the data source.

Dispose()

Habilita un control de servidor para que realice la limpieza final antes de que se libere de la memoria.Enables a server control to perform final clean up before it is released from memory.

(Heredado de Control)
EndRenderTracing(TextWriter, Object)

Finaliza el seguimiento en tiempo de diseño de los datos de representación.Ends design-time tracing of rendering data.

(Heredado de Control)
EnsureChildControls()

Determina si el control de servidor contiene controles secundarios.Determines whether the server control contains child controls. Si no tiene controles secundarios, los crea.If it does not, it creates child controls.

(Heredado de Control)
EnsureDataBound()

Llama al método DataBind() si se establece la propiedad DataSourceID y el control enlazado a datos está marcado de forma que requiera el enlace.Calls the DataBind() method if the DataSourceID property is set and the data-bound control is marked to require binding.

(Heredado de BaseDataBoundControl)
EnsureID()

Crea un identificador para controles que no tiene un identificador asignado.Creates an identifier for controls that do not have an identifier assigned.

(Heredado de Control)
EnsureLayoutTemplate()

Garantiza que el contenido de LayoutTemplate se cree correctamente en el control ListView.Ensures that the LayoutTemplate content is correctly created in the ListView control.

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
ExtractItemValues(IOrderedDictionary, ListViewItem, Boolean)

Recupera los valores de cada campo declarado en el elemento especificado y los almacena en el objeto IOrderedDictionary especificado.Retrieves the values of each field that is declared in the specified item, and stores them in the specified IOrderedDictionary object.

FindControl(String)

Busca un control de servidor con el parámetro id especificado en el contenedor de nomenclatura actual.Searches the current naming container for a server control with the specified id parameter.

(Heredado de Control)
FindControl(String, Int32)

Busca el contenedor de nomenclatura actual para un control de servidor con el id especificado y un entero, que se especifica en el parámetro pathOffset, que ayuda a realizar la búsqueda.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Esta versión del método FindControl no se debe reemplazar.You should not override this version of the FindControl method.

(Heredado de Control)
FindPlaceholder(String, Control)

Busca un control con el identificador especificado en el contenedor especificado.Searches the specified container for a control that has the specified identifier.

Focus()

Establece el foco de entrada en un control.Sets input focus to a control.

(Heredado de Control)
GetData()

Recupera un objeto DataSourceView que el control enlazado a datos usa para llevar a cabo operaciones de datos.Retrieves a DataSourceView object that the data-bound control uses to perform data operations.

(Heredado de DataBoundControl)
GetDataSource()

Recupera la interfaz IDataSource a la que se asocia el control enlazado a datos, si existe.Retrieves the IDataSource interface that the data-bound control is associated with, if any.

(Heredado de DataBoundControl)
GetDesignModeState()

Obtiene datos en tiempo de diseño para un control.Gets design-time data for a control.

(Heredado de Control)
GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetRouteUrl(Object)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.Gets the URL that corresponds to a set of route parameters.

(Heredado de Control)
GetRouteUrl(RouteValueDictionary)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.Gets the URL that corresponds to a set of route parameters.

(Heredado de Control)
GetRouteUrl(String, Object)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta.Gets the URL that corresponds to a set of route parameters and a route name.

(Heredado de Control)
GetRouteUrl(String, RouteValueDictionary)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta.Gets the URL that corresponds to a set of route parameters and a route name.

(Heredado de Control)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
GetUniqueIDRelativeTo(Control)

Devuelve la parte correspondiente al prefijo de la propiedad UniqueID del control especificado.Returns the prefixed portion of the UniqueID property of the specified control.

(Heredado de Control)
HasControls()

Determina si el control de servidor contiene controles secundarios.Determines if the server control contains any child controls.

(Heredado de Control)
HasEvents()

Devuelve un valor que indica si se registran eventos para el control o los controles secundarios.Returns a value indicating whether events are registered for the control or any child controls.

(Heredado de Control)
InsertNewItem(Boolean)

Inserta el registro actual en el origen de datos.Inserts the current record in the data source.

InstantiateEmptyDataTemplate(Control)

Rellena el objeto Control especificado utilizando los controles secundarios incluidos en la plantilla EmptyDataTemplate.Populates the specified Control object by using the child controls that are contained in the EmptyDataTemplate template.

InstantiateEmptyItemTemplate(Control)

Rellena el objeto Control especificado utilizando los controles secundarios incluidos en la plantilla EmptyItemTemplate.Populates the specified Control object by using the child controls that are contained in the EmptyItemTemplate template.

InstantiateGroupSeparatorTemplate(Control)

Rellena el objeto Control especificado utilizando los controles secundarios incluidos en la plantilla GroupSeparatorTemplate.Populates the specified Control object by using the child controls that are contained in the GroupSeparatorTemplate template.

InstantiateGroupTemplate(Control)

Rellena el objeto Control especificado utilizando los controles secundarios incluidos en la plantilla GroupTemplate.Populates the specified Control object by using the child controls that are contained in the GroupTemplate template.

InstantiateInsertItemTemplate(Control)

Rellena el objeto Control especificado utilizando los controles secundarios incluidos en la plantilla InsertItemTemplate.Populates the specified Control object by using the child controls that are contained in the InsertItemTemplate template.

InstantiateItemSeparatorTemplate(Control)

Rellena el objeto Control especificado utilizando los controles secundarios incluidos en la plantilla ItemSeparatorTemplate.Populates the specified Control object by using the child controls that are contained in the ItemSeparatorTemplate template.

InstantiateItemTemplate(Control, Int32)

Rellena el objeto Control especificado utilizando los controles secundarios de una de las plantillas de control de ListView.Populates the specified Control object by using child controls from one of the ListView control templates.

IsLiteralContent()

Determina si el control de servidor alberga únicamente contenido literal.Determines if the server control holds only literal content.

(Heredado de Control)
LoadControlState(Object)

Carga el estado de las propiedades del control ListView que deben conservarse, incluso cuando la propiedad EnableViewState está establecida en false.Loads the state of the properties in the ListView control that must be persisted, even when the EnableViewState property is set to false.

LoadViewState(Object)

Carga el estado de vista previamente guardado del control ListView.Loads the previously saved view state of the ListView control.

MapPathSecure(String)

Recupera la ruta de acceso física a la que se asigna una ruta de acceso virtual, absoluta o relativa.Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Heredado de Control)
MarkAsDataBound()

Establece el estado del control en estado de vista como enlazado correctamente a los datos.Sets the state of the control in view state as successfully bound to data.

(Heredado de DataBoundControl)
MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
MergeStyle(Style)

Copia en el control Web todos los elementos no vacíos del estilo especificado, pero no sobrescribe los elementos de estilo existentes en el mismo.Copies any nonblank elements of the specified style to the Web control, but will not overwrite any existing style elements of the control. Este método lo usan principalmente los desarrolladores de controles.This method is used primarily by control developers.

(Heredado de WebControl)
OnBubbleEvent(Object, EventArgs)

Determina si debe administrarse un evento para el control ListView.Determines whether an event for the ListView control should be handled.

OnCreatingModelDataSource(CreatingModelDataSourceEventArgs)

Inicia el evento CreatingModelDataSource.Raises the CreatingModelDataSource event.

(Heredado de DataBoundControl)
OnDataBinding(EventArgs)

Inicia el evento DataBinding.Raises the DataBinding event.

(Heredado de Control)
OnDataBound(EventArgs)

Inicia el evento DataBound.Raises the DataBound event.

(Heredado de BaseDataBoundControl)
OnDataPropertyChanged()

Vuelve a enlazar el control enlazado a datos a sus datos después de un cambio en una de las propiedades de identificación del origen de datos base.Rebinds the data-bound control to its data after one of the base data source identification properties changes.

(Heredado de DataBoundControl)
OnDataSourceViewChanged(Object, EventArgs)

Inicia el evento DataSourceViewChanged.Raises the DataSourceViewChanged event.

(Heredado de DataBoundControl)
OnInit(EventArgs)

Inicia el evento Init.Raises the Init event.

OnItemCanceling(ListViewCancelEventArgs)

Inicia el evento ItemCanceling.Raises the ItemCanceling event.

OnItemCommand(ListViewCommandEventArgs)

Inicia el evento ItemCommand.Raises the ItemCommand event.

OnItemCreated(ListViewItemEventArgs)

Inicia el evento ItemCreated.Raises the ItemCreated event.

OnItemDataBound(ListViewItemEventArgs)

Inicia el evento ItemDataBound.Raises the ItemDataBound event.

OnItemDeleted(ListViewDeletedEventArgs)

Inicia el evento ItemDeleted.Raises the ItemDeleted event.

OnItemDeleting(ListViewDeleteEventArgs)

Inicia el evento ItemDeleting.Raises the ItemDeleting event.

OnItemEditing(ListViewEditEventArgs)

Inicia el evento ItemEditing.Raises the ItemEditing event.

OnItemInserted(ListViewInsertedEventArgs)

Inicia el evento ItemInserted.Raises the ItemInserted event.

OnItemInserting(ListViewInsertEventArgs)

Inicia el evento ItemInserting.Raises the ItemInserting event.

OnItemUpdated(ListViewUpdatedEventArgs)

Inicia el evento ItemUpdated.Raises the ItemUpdated event.

OnItemUpdating(ListViewUpdateEventArgs)

Inicia el evento ItemUpdating.Raises the ItemUpdating event.

OnLayoutCreated(EventArgs)

Inicia el evento LayoutCreated.Raises the LayoutCreated event.

OnLoad(EventArgs)

Controla el evento Load.Handles the Load event.

(Heredado de DataBoundControl)
OnPagePreLoad(Object, EventArgs)

Establece el estado inicializado del control enlazado a datos antes de cargar el control.Sets the initialized state of the data-bound control before the control is loaded.

(Heredado de DataBoundControl)
OnPagePropertiesChanged(EventArgs)

Inicia el evento PagePropertiesChanged.Raises the PagePropertiesChanged event.

OnPagePropertiesChanging(PagePropertiesChangingEventArgs)

Inicia el evento PagePropertiesChanging.Raises the PagePropertiesChanging event.

OnPreRender(EventArgs)

Controla el evento PreRender.Handles the PreRender event.

(Heredado de BaseDataBoundControl)
OnSelectedIndexChanged(EventArgs)

Inicia el evento SelectedIndexChanged.Raises the SelectedIndexChanged event.

OnSelectedIndexChanging(ListViewSelectEventArgs)

Inicia el evento SelectedIndexChanging.Raises the SelectedIndexChanging event.

OnSorted(EventArgs)

Inicia el evento Sorted.Raises the Sorted event.

OnSorting(ListViewSortEventArgs)

Inicia el evento Sorting.Raises the Sorting event.

OnTotalRowCountAvailable(PageEventArgs)

Inicia el evento IPageableItemContainer.TotalRowCountAvailable.Raises the IPageableItemContainer.TotalRowCountAvailable event.

OnUnload(EventArgs)

Inicia el evento Unload.Raises the Unload event.

(Heredado de Control)
OpenFile(String)

Obtiene un objeto Stream utilizado para leer un archivo.Gets a Stream used to read a file.

(Heredado de Control)
PerformDataBinding(IEnumerable)

Enlaza el control ListView al origen de datos especificado.Binds the ListView control to the specified data source.

PerformSelect()

Recupera los datos del origen de datos asociado.Retrieves data from the associated data source.

RaiseBubbleEvent(Object, EventArgs)

Asigna los orígenes del evento y su información al control principal del control.Assigns any sources of the event and its information to the control's parent.

(Heredado de Control)
RemovedControl(Control)

Se llama después de quitar un control secundario de la colección Controls del objeto Control.Called after a child control is removed from the Controls collection of the Control object.

(Heredado de Control)
RemoveItems()

Elimina todos los controles secundarios de un contenedor de elementos o grupos del control ListView.Deletes all child controls in an item or group container of the ListView control.

Render(HtmlTextWriter)

Representa el contenido del control de servidor web en el explorador del cliente por medio del objeto HtmlTextWriter especificado.Renders the Web server control content to the client's browser by using the specified HtmlTextWriter object.

RenderBeginTag(HtmlTextWriter)

Representa la etiqueta HTML de apertura del control en el sistema de escritura especificado.Renders the HTML opening tag of the control to the specified writer. Este método lo usan principalmente los desarrolladores de controles.This method is used primarily by control developers.

(Heredado de WebControl)
RenderChildren(HtmlTextWriter)

Envía el contenido de los elementos secundarios de un control de servidor a un objeto HtmlTextWriter especificado, que escribe el contenido que se va a representar en el cliente.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Heredado de Control)
RenderContents(HtmlTextWriter)

Representa el contenido del control en el sistema de escritura especificado.Renders the contents of the control to the specified writer. Este método lo usan principalmente los desarrolladores de controles.This method is used primarily by control developers.

(Heredado de WebControl)
RenderControl(HtmlTextWriter)

Envía el contenido de control del servidor a un objeto HtmlTextWriter proporcionado y almacena información de seguimiento sobre el control si está habilitado el seguimiento.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Heredado de Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Coloca el contenido de un control de servidor en un objeto HtmlTextWriter proporcionado, utilizando un objeto ControlAdapter proporcionado.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Heredado de Control)
RenderEndTag(HtmlTextWriter)

Presenta la etiqueta HTML de cierre del control en el escritor especificado.Renders the HTML closing tag of the control into the specified writer. Este método lo usan principalmente los desarrolladores de controles.This method is used primarily by control developers.

(Heredado de WebControl)
ResolveAdapter()

Obtiene el adaptador de controles que se encarga de representar el control especificado.Gets the control adapter responsible for rendering the specified control.

(Heredado de Control)
ResolveClientUrl(String)

Obtiene una dirección URL que el explorador puede utilizar.Gets a URL that can be used by the browser.

(Heredado de Control)
ResolveUrl(String)

Convierte una dirección URL en una que el cliente solicitante pueda utilizar.Converts a URL into one that is usable on the requesting client.

(Heredado de Control)
SaveControlState()

Guarda el estado de las propiedades del control ListView que deben conservarse, incluso cuando la propiedad EnableViewState está establecida en false.Saves the state of the properties in the ListView control that must be persisted, even when the EnableViewState property is set to false.

SaveViewState()

Guarda el estado de vista actual del control ListView.Saves the current view state of the ListView control.

SelectItem(Int32)

Selecciona el elemento que está en modo de edición en un control ListView.Selects the item that is in edit mode in a ListView control.

SetDesignModeState(IDictionary)

Establece los datos en tiempo de diseño para un control.Sets design-time data for a control.

(Heredado de Control)
SetEditItem(Int32)

Establece el elemento especificado en modo de edición en un control ListView.Sets the specified item into edit mode in a ListView control.

SetPageProperties(Int32, Int32, Boolean)

Establece las propiedades de una página de datos en el control ListView.Sets the properties of a page of data in the ListView control.

SetRenderMethodDelegate(RenderMethod)

Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en el control principal.Assigns an event handler delegate to render the server control and its content into its parent control.

(Heredado de Control)
SetTraceData(Object, Object)

Establece datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, para lo que usa la clave y el valor de los datos de seguimiento.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(Heredado de Control)
SetTraceData(Object, Object, Object)

Establece datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, para lo que usa el objeto del que se ha realizado seguimiento, así como la clave y el valor de los datos de seguimiento.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Heredado de Control)
Sort(String, SortDirection)

Ordena el control ListView, en función de la expresión y dirección de ordenación especificadas.Sorts the ListView control, depending on the specified sort expression and direction.

ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)
TrackViewState()

Origina el seguimiento de los cambios del estado de vista del control de manera que se puedan almacenar en el objeto StateBag del control.Causes view-state changes to the control to be tracked so they can be stored in the control's StateBag object.

(Heredado de DataBoundControl)
UpdateItem(Int32, Boolean)

Actualiza el registro en el índice especificado del origen de datos.Updates the record at the specified index in the data source.

ValidateDataSource(Object)

Comprueba que el objeto al que se enlaza un control enlazado a datos es compatible.Verifies that the object a data-bound control binds to is one it can work with.

(Heredado de DataBoundControl)

Eventos

CallingDataMethods

Se produce mientras se llama a los métodos de datos.Occurs when data methods are being called.

(Heredado de DataBoundControl)
CreatingModelDataSource

Se produce mientras se crea el objeto ModelDataSource.Occurs when the ModelDataSource object is being created.

(Heredado de DataBoundControl)
DataBinding

Se produce cuando el control de servidor se enlaza a un origen de datos.Occurs when the server control binds to a data source.

(Heredado de Control)
DataBound

Se produce después de que el control de servidor se enlaza a un origen de datos.Occurs after the server control binds to a data source.

(Heredado de BaseDataBoundControl)
Disposed

Se produce cuando un control de servidor se libera de la memoria, lo que constituye la última fase del período de duración de un control de servidor cuando se solicita una página ASP.NET.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(Heredado de Control)
Init

Tiene lugar al inicializar el control de servidor, que es el primer paso en su ciclo de vida.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Heredado de Control)
ItemCanceling

Se produce cuando se solicita una operación de cancelación, pero antes de que el control ListView cancele la operación de inserción o edición.Occurs when a cancel operation is requested, but before the ListView control cancels the insert or edit operation.

ItemCommand

Se produce cuando se hace clic en un botón de un control ListView.Occurs when a button in a ListView control is clicked.

ItemCreated

Se produce cuando se crea un elemento en un control ListView.Occurs when an item is created in a ListView control.

ItemDataBound

Se produce cuando un elemento de datos de un control ListView se enlaza a datos.Occurs when a data item is bound to data in a ListView control.

ItemDeleted

Se produce cuando se solicita una operación de eliminación, después de que el control ListView elimine el elemento.Occurs when a delete operation is requested, after the ListView control deletes the item.

ItemDeleting

Se produce cuando se solicita una operación de eliminación, pero antes de que el control ListView elimine el elemento.Occurs when a delete operation is requested, but before the ListView control deletes the item.

ItemEditing

Se produce cuando se solicita una operación de edición, pero antes de que el elemento ListView se ponga en modo de edición.Occurs when an edit operation is requested, but before the ListView item is put in edit mode.

ItemInserted

Se produce cuando se solicita una operación de inserción, después de que el control ListView haya insertado el elemento en el origen de datos.Occurs when an insert operation is requested, after the ListView control has inserted the item in the data source.

ItemInserting

Se produce cuando se solicita una operación de inserción, pero antes de que el control ListView efectúe la inserción.Occurs when an insert operation is requested, but before the ListView control performs the insert.

ItemUpdated

Se produce cuando se solicita una operación de actualización, después de que el control ListView actualice el elemento.Occurs when an update operation is requested, after the ListView control updates the item.

ItemUpdating

Se produce cuando se solicita una operación de actualización, pero antes de que el control ListView actualice el elemento.Occurs when an update operation is requested, but before the ListView control updates the item.

LayoutCreated

Se produce cuando la plantilla LayoutTemplate se crea en un control ListView.Occurs when the LayoutTemplate template is created in a ListView control.

Load

Se produce cuando el control de servidor se carga en el objeto Page.Occurs when the server control is loaded into the Page object.

(Heredado de Control)
PagePropertiesChanged

Se produce cuando cambian las propiedades de página, después de que el control ListView establezca los nuevos valores.Occurs when the page properties change, after the ListView control sets the new values.

PagePropertiesChanging

Se produce cuando cambian las propiedades de página, pero antes de que el control ListView establezca los nuevos valores.Occurs when the page properties change, but before the ListView control sets the new values.

PreRender

Se produce una vez que se carga el objeto Control, pero antes de su representación.Occurs after the Control object is loaded but prior to rendering.

(Heredado de Control)
SelectedIndexChanged

Se produce cuando se hace clic en el botón Seleccionar de un elemento, después de que el control ListView administre la operación de selección.Occurs when an item's Select button is clicked, after the ListView control handles the select operation.

SelectedIndexChanging

Se produce cuando se hace clic en el botón Seleccionar de un elemento, pero antes de que el control ListView administre la operación de selección.Occurs when an item's Select button is clicked, but before the ListView control handles the select operation.

Sorted

Se produce cuando se solicita una operación de ordenación, después de que el control ListView administre la operación de ordenación.Occurs when a sort operation is requested, after the ListView control handles the sort operation.

Sorting

Se produce cuando se solicita una operación de ordenación, pero antes de que el control ListView administre la operación de ordenación.Occurs when a sort operation is requested, but before the ListView control handles the sort operation.

Unload

Se produce cuando el control de servidor se descarga de la memoria.Occurs when the server control is unloaded from memory.

(Heredado de Control)

Implementaciones de interfaz explícitas

IAttributeAccessor.GetAttribute(String)

Obtiene un atributo del control Web con el nombre especificado.Gets an attribute of the Web control with the specified name.

(Heredado de WebControl)
IAttributeAccessor.SetAttribute(String, String)

Establece un atributo del control Web con el nombre y el valor especificados.Sets an attribute of the Web control to the specified name and value.

(Heredado de WebControl)
IControlBuilderAccessor.ControlBuilder

Para una descripción de este miembro, vea ControlBuilder.For a description of this member, see ControlBuilder.

(Heredado de Control)
IControlDesignerAccessor.GetDesignModeState()

Para una descripción de este miembro, vea GetDesignModeState().For a description of this member, see GetDesignModeState().

(Heredado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Para una descripción de este miembro, vea SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

(Heredado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Para una descripción de este miembro, vea SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

(Heredado de Control)
IControlDesignerAccessor.UserData

Para una descripción de este miembro, vea UserData.For a description of this member, see UserData.

(Heredado de Control)
IDataBindingsAccessor.DataBindings

Para una descripción de este miembro, vea DataBindings.For a description of this member, see DataBindings.

(Heredado de Control)
IDataBindingsAccessor.HasDataBindings

Para una descripción de este miembro, vea HasDataBindings.For a description of this member, see HasDataBindings.

(Heredado de Control)
IDataBoundControl.DataKeyNames

Obtiene o establece una matriz que contiene los nombres de los campos de clave principal de los elementos que se muestran en un control enlazado a datos.Gets or sets an array that contains the names of the primary-key fields of the items that are displayed in a data-bound control.

IDataBoundControl.DataMember

Obtiene o establece el nombre de la lista de datos a la que se enlaza el control enlazado a datos cuando el origen de datos contiene más de una lista distinta de elementos de datos.Gets or sets the name of the list of data that the data-bound control binds to when the data source contains more than one distinct list of data items.

IDataBoundControl.DataSource

Obtiene o establece el objeto del que el control enlazado a datos recupera su lista de elementos de datos.Gets or sets the object from which a data-bound control retrieves its list of data items.

IDataBoundControl.DataSourceID

Obtiene o establece el identificador del control de origen de datos del cual un control enlazado a datos recupera su lista de elementos de datos.Gets or sets the ID of the data source control from which a data-bound control retrieves its list of data items.

IDataBoundControl.DataSourceObject

Obtiene un objeto que implementa la interfaz IDataSource, que proporciona acceso al contenido de datos del objeto.Gets an object that implements the IDataSource interface, which provides access to the object's data content.

IDataBoundListControl.ClientIDRowSuffix

Obtiene el nombre del campo de datos cuyo valor se utiliza para identificar de manera única cada fila de datos de un control ListView cuando la propiedad ClientIDMode está establecida en Predictable.Gets the name of the data field whose value is used to uniquely identify each data row of a ListView control when the ClientIDMode property is set to Predictable.

IDataBoundListControl.DataKeys

Obtiene una colección de valores de clave de datos que representan cada fila de un control enlazado a datos.Gets a collection of data-key values that represent each row in a data-bound control.

IDataBoundListControl.EnablePersistedSelection

Obtiene o establece el valor que especifica si se conserva la selección de una fila cuando un usuario se desplaza por los datos en un control enlazado a datos.Gets or sets the value that specifies whether a selected row persists when a user pages through data in a data-bound control.

IDataBoundListControl.SelectedDataKey

Obtiene el objeto de clave de datos que contiene el valor de clave de datos de la fila seleccionada en un control enlazado a datos.Gets the data-key object that contains the data-key value for the selected row in a data-bound control.

IDataBoundListControl.SelectedIndex

Obtiene o establece el índice de la fila seleccionada en un control enlazado a datos.Gets or sets the index of the selected row in a data-bound control.

IDataKeysControl.ClientIDRowSuffixDataKeys

Obtiene una colección de los valores de datos que se usan para identificar de manera única cada instancia de un control enlazado a datos cuando ASP.NET genera el valor de ClientID.Gets a collection of the data values that are used to uniquely identify each instance of a data-bound control when ASP.NET generates the ClientID value.

IExpressionsAccessor.Expressions

Para una descripción de este miembro, vea Expressions.For a description of this member, see Expressions.

(Heredado de Control)
IExpressionsAccessor.HasExpressions

Para una descripción de este miembro, vea HasExpressions.For a description of this member, see HasExpressions.

(Heredado de Control)
IPageableItemContainer.MaximumRows

Para obtener una descripción de este miembro, vea MaximumRows.For a description of this member, see MaximumRows.

IPageableItemContainer.SetPageProperties(Int32, Int32, Boolean)

Para obtener una descripción de este miembro, vea SetPageProperties(Int32, Int32, Boolean).For a description of this member, see SetPageProperties(Int32, Int32, Boolean).

IPageableItemContainer.StartRowIndex

Para obtener una descripción de este miembro, vea StartRowIndex.For a description of this member, see StartRowIndex.

IPageableItemContainer.TotalRowCountAvailable

Para obtener una descripción de este miembro, vea TotalRowCountAvailable.For a description of this member, see TotalRowCountAvailable.

IParserAccessor.AddParsedSubObject(Object)

Para una descripción de este miembro, vea AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

(Heredado de Control)
IPersistedSelector.DataKey

Obtiene o establece el valor de clave de datos del registro seleccionado en un control enlazado a datos.Gets or sets the data-key value for the selected record in a data-bound control.

IWizardSideBarListControl.Items

Métodos de extensión

EnablePersistedSelection(BaseDataBoundControl)

Habilita la selección para que persista en controles de datos que admiten selección y paginación.Enables selection to be persisted in data controls that support selection and paging.

FindDataSourceControl(Control)

Devuelve el origen de datos que está asociado al control de datos del control especificado.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

Devuelve la plantilla de campo para la columna especificada en el contenedor de nomenclatura del control especificado.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

Devuelve el objeto de metatabla para el control de datos contenedor.Returns the metatable object for the containing data control.

GetDefaultValues(INamingContainer)

Obtiene la colección de los valores predeterminados para el control de datos especificado.Gets the collection of the default values for the specified data control.

GetMetaTable(INamingContainer)

Obtiene los metadatos de la tabla para el control de datos especificado.Gets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable)

Establece los metadatos de la tabla para el control de datos especificado.Sets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

Establece los metadatos de tabla y la asignación de valores predeterminados para el control de datos especificado.Sets the table metadata and default value mapping for the specified data control.

SetMetaTable(INamingContainer, MetaTable, Object)

Establece los metadatos de tabla y la asignación de valores predeterminados para el control de datos especificado.Sets the table metadata and default value mapping for the specified data control.

TryGetMetaTable(INamingContainer, MetaTable)

Determina si están disponibles los metadatos de la tabla.Determines whether table metadata is available.

EnableDynamicData(INamingContainer, Type)

Habilita el comportamiento de datos dinámicos para el control de datos especificado.Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

Habilita el comportamiento de datos dinámicos para el control de datos especificado.Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, Object)

Habilita el comportamiento de datos dinámicos para el control de datos especificado.Enables Dynamic Data behavior for the specified data control.

Se aplica a

Consulte también: