ListView Classe

Definição

Exibe os valores de uma fonte de dados usando modelos definidos pelo usuário. O controle ListView permite aos usuários selecionar, classificar, excluir, editar e inserir registros.

public ref class ListView : System::Web::UI::WebControls::DataBoundControl, System::Web::UI::INamingContainer, System::Web::UI::WebControls::IPageableItemContainer, System::Web::UI::WebControls::IPersistedSelector
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.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.ListView), "ListView.ico")]
[System.Web.UI.ControlValueProperty("SelectedValue")]
public class ListView : System.Web.UI.WebControls.DataBoundControl, System.Web.UI.INamingContainer, 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.bmp")]
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.ico")>]
[<System.Web.UI.ControlValueProperty("SelectedValue")>]
type ListView = class
    inherit DataBoundControl
    interface INamingContainer
    interface IPageableItemContainer
    interface IPersistedSelector
[<System.Web.UI.ControlValueProperty("SelectedValue")>]
[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.ListView), "ListView.bmp")>]
type ListView = class
    inherit DataBoundControl
    interface INamingContainer
    interface IPageableItemContainer
    interface IPersistedSelector
    interface IDataKeysControl
    interface IDataBoundListControl
    interface IDataBoundControl
Public Class ListView
Inherits DataBoundControl
Implements INamingContainer, IPageableItemContainer, IPersistedSelector
Public Class ListView
Inherits DataBoundControl
Implements IDataBoundListControl, IDataKeysControl, INamingContainer, IPageableItemContainer, IPersistedSelector
Herança
Atributos
Implementações

Exemplos

O exemplo a seguir mostra como usar o ListView controle para exibir registros de um banco de dados usando uma tabela HTML. Os valores são recuperados usando um LinqDataSource controle .

<%@ 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>

O exemplo a seguir mostra como usar o ListView controle para exibir valores em um layout de fluxo usando o div elemento . Os valores são recuperados usando um SqlDataSource controle .

<%@ 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>

O exemplo a seguir mostra como usar o ListView controle para inserir, excluir e atualizar registros.

Importante

Este exemplo tem uma caixa de texto que aceita a entrada do usuário, que é uma possível ameaça à segurança. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos html ou script. Para obter mais informações, consulte Visão geral de explorações de script.

<%@ 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>

Comentários

Neste tópico:

Introdução

O ListView controle é usado para exibir os valores de uma fonte de dados. Ele se assemelha ao GridView controle , exceto que ele exibe dados usando modelos definidos pelo usuário em vez de campos de linha. Criar seus próprios modelos oferece mais flexibilidade para controlar como os dados são exibidos.

Um projeto do Visual Studio com código-fonte está disponível para acompanhar este tópico: Baixar.

O ListView controle dá suporte aos seguintes recursos:

  • Suporte para associação a controles de fonte de dados, como SqlDataSource, LinqDataSourcee ObjectDataSource.

  • Aparência personalizável por meio de modelos e estilos definidos pelo usuário.

  • Recursos de classificação internos.

  • Recursos internos de atualização e exclusão.

  • Recursos internos de inserção.

  • Suporte para recursos de paginação usando um DataPager controle .

  • Recursos internos de seleção de itens.

  • Acesso programático ao ListView modelo de objeto para definir dinamicamente propriedades, manipular eventos e assim por diante.

  • Vários campos de chave.

Para saber mais sobre outros controles associados a dados que estão disponíveis em ASP.NET, consulte Controles de servidor Web associados a dados.

Modelos

Para que o ListView controle exiba conteúdo, você deve criar modelos para diferentes partes do controle. A ItemTemplate é obrigatória. Todos os outros modelos são opcionais. A LayoutTemplate propriedade não é necessária.

No entanto, você deve criar um modelo para o modo no qual o controle está configurado. Por exemplo, um ListView controle que dá suporte à inserção de registros deve ter um InsertItemTemplate modelo definido. A tabela a seguir lista os modelos que você pode criar para o ListView controle .

Tipo do modelo Descrição
LayoutTemplate O modelo raiz que define um objeto de contêiner, como um tableelemento , divou span , que conterá o conteúdo definido no ItemTemplate modelo ou GroupTemplate . Ele também pode conter um DataPager objeto .
ItemTemplate Define o conteúdo associado a dados a ser exibido para itens individuais.
ItemSeparatorTemplate Define o conteúdo a ser renderizado entre itens individuais.
GroupTemplate Define um objeto de contêiner, como uma linha de tabela (tr), divou span elemento , que conterá o conteúdo definido nos ItemTemplate modelos e EmptyItemTemplate . O número de itens exibidos em um grupo é especificado pela GroupItemCount propriedade .
GroupSeparatorTemplate Define o conteúdo a ser renderizado entre grupos de itens.
EmptyItemTemplate Define o conteúdo a ser renderizado para um item vazio quando um GroupTemplate modelo é usado. Por exemplo, se a GroupItemCount propriedade for definida como 5 e o número total de itens retornados da fonte de dados for 8, o último grupo de dados exibido pelo ListView controle conterá três itens, conforme especificado pelo ItemTemplate modelo, e dois itens, conforme especificado pelo EmptyItemTemplate modelo.
EmptyDataTemplate Define o conteúdo a ser renderizado se a fonte de dados não retornar dados.
SelectedItemTemplate Define o conteúdo a ser renderizado para o item de dados selecionado para diferenciar o item selecionado de outros itens.
AlternatingItemTemplate Define o conteúdo a ser renderizado para itens alternados para facilitar a distinção entre itens consecutivos.
EditItemTemplate Define o conteúdo a ser renderizado quando um item está sendo editado. O EditItemTemplate modelo é renderizado no lugar do ItemTemplate modelo para o item de dados que está sendo editado.
InsertItemTemplate Define o conteúdo a ser renderizado para inserir um item. O InsertItemTemplate modelo é renderizado no lugar de um ItemTemplate modelo no início ou no final dos itens exibidos pelo ListView controle. Você pode especificar onde o InsertItemTemplate modelo é renderizado usando a InsertItemPosition propriedade do ListView controle .

Para exibir o valor de um campo em um modelo como ItemTemplate, use uma expressão de associação de dados. Para obter mais informações sobre expressões de associação de dados, consulte Visão geral de expressões de associação de dados.

Para associar controles EditItemTemplate de entrada nos modelos e InsertItemTemplate a campos de uma fonte de dados, você pode usar expressões de associação bidirecionais. Isso permite que o ListView controle extraia automaticamente os valores do controle de entrada para uma operação de atualização ou inserção. Expressões de associação bidirecional também permitem que os controles de entrada em um EditItemTemplate exibam automaticamente os valores de campo originais. Para obter mais informações sobre expressões de associação bidirecional, consulte Associação a bancos de dados.

Associação a uma fonte de dados

Você pode associar o ListView controle a um controle de fonte de dados (como o SqlDataSource controle ou ObjectDataSource controle) ou a qualquer coleção de fonte de dados que implemente a System.Collections.IEnumerable interface, como System.Data.DataView, System.Collections.ArrayList, System.Collections.Generic.List<T>ou outros tipos de coleção. Use um dos seguintes métodos para associar o ListView controle ao tipo de fonte de dados apropriado:

  • Para associar a um controle de fonte de dados, defina a DataSourceID propriedade do ListView controle como o ID valor do controle da fonte de dados. O ListView controle é associado automaticamente ao controle da fonte de dados especificado e pode aproveitar os recursos do controle da fonte de dados para executar a funcionalidade de classificação, inserção, atualização, exclusão e paginação. Esse é o método preferencial para associar a dados.

  • Para associar a uma fonte de dados que implementa a System.Collections.IEnumerable interface, defina programaticamente a DataSource propriedade do ListView controle como a fonte de dados e, em seguida, chame o DataBind método . Quando você usa essa técnica, o ListView controle não fornece funcionalidades internas de classificação, atualização, exclusão e paginação. Você deve fornecer essa funcionalidade usando o evento apropriado.

Para obter mais informações sobre a associação de dados, consulte ASP.NET Mapa de Conteúdo de Acesso a Dados.

Observação

O ListView controle pode ser usado para exibir a entrada do usuário, que pode incluir script de cliente mal-intencionado. Verifique as informações enviadas de um cliente para script executável, instruções SQL ou outro código antes de exibi-lo no aplicativo. É altamente recomendável que os valores sejam codificados em HTML sempre que possível antes de serem exibidos nesse controle. ASP.NET fornece um recurso de validação de solicitação de entrada para ajudar a bloquear script e HTML na entrada do usuário. Você também pode usar controles de servidor de validação para marcar entrada do usuário. Para obter mais informações, consulte Introdução aos controles de validação.

Operações de dados

Quando o ListView controle está associado a um controle de fonte de dados, o ListView controle pode aproveitar os recursos do controle da fonte de dados e fornecer funcionalidades automáticas de classificação, inserção, atualização e exclusão.

Observação

O ListView controle pode fornecer suporte para classificação, inserção, atualização e exclusão com outros tipos de fontes de dados. No entanto, para implementar essas operações, você deve criar código em um manipulador de eventos apropriado.

Como o ListView controle usa modelos, ele não fornece uma maneira de gerar automaticamente botões para executar operações de atualização, exclusão, inserção, classificação ou seleção. Você deve incluir manualmente esses botões no modelo apropriado. O ListView controle reconhece determinados botões cuja CommandName propriedade é definida como um valor específico. A tabela a seguir lista os botões que o ListView controle reconhece e suas funções.

Botão Valor de CommandName Descrição
Cancelar "Cancelar" Cancela uma operação de edição ou inserção. Aciona o evento ItemCanceling.
Excluir "Excluir" Exclui o registro atual da fonte de dados. Gera os ItemDeleted eventos e ItemDeleting .
Selecionar "Selecionar" Define a SelectedIndex propriedade como o valor da DisplayIndex propriedade do item. Renderiza o SelectedItemTemplate modelo para o item. Gera os SelectedIndexChanging eventos e SelectedIndexChanged .
Editar "Editar" Coloca o item no modo de edição. Renderiza o EditItemTemplate modelo para o item. Aciona o evento ItemEditing.
Inserir "Inserir" Insere os valores associados do InsertItemTemplate modelo na fonte de dados. Gera os ItemInserting eventos e ItemInserted .
Atualizar "Atualizar" Atualizações o registro atual na fonte de dados com os valores associados do EditItemTemplate modelo. Gera os ItemUpdating eventos e ItemUpdated .
Classificar "Classificar" Classifica as colunas listadas na CommandArgument propriedade do botão. Gera os Sorting eventos e Sorted .

Ao contrário do botão Excluir (que exclui o item de dados atual imediatamente), quando o botão Editar é clicado, o ListView controle exibe o item atual no modo de edição. No modo de edição, o conteúdo contido na EditItemTemplate propriedade é exibido para o item de dados atual. Normalmente, no modelo editar item, o botão Editar é substituído por um botão Atualizar e Cancelar. Os controles de entrada apropriados para o tipo de dados do campo (como um TextBox controle ou CheckBox ) também geralmente exibem o valor de um campo para um usuário modificar. Clicar no botão Atualizar atualiza o registro na fonte de dados e clicar no botão Cancelar cancela a operação de edição.

A funcionalidade de inserção é habilitada quando a InsertItemPosition propriedade é definida FirstItem como ou LastItem. Essa propriedade define onde o InsertItemTemplate modelo é renderizado para o item de inserção. O modelo inserir item normalmente inclui um botão Inserir e Cancelar, e controles de entrada vazios são exibidos para que os usuários insiram os valores do novo registro. Clicar no botão Inserir insere o registro na fonte de dados e clicar no botão Cancelar limpa todos os campos.

Classificação

O ListView controle permite que os usuários classifiquem os itens clicando no botão Classificar. A funcionalidade de classificação é definida na CommandArgument propriedade do botão que contém as colunas a serem classificadas.

Paginamento

Em vez de exibir todos os registros da fonte de dados ao mesmo tempo, o ListView controle pode dividir os registros em páginas. Para habilitar a paginação, associe um DataPager controle ao ListView controle . Em seguida, insira um DataPager controle dentro do LayoutTemplate modelo. Como alternativa, se o DataPager controle estiver fora do ListView controle, defina a PagedControlID propriedade como o IDListView do controle .

Eventos

A tabela a seguir lista os eventos compatíveis com o ListView controle .

Evento Descrição
ItemCanceling Ocorre quando o botão Cancelar (um botão com sua CommandName propriedade definida como "Cancelar") é clicado, mas antes que o ListView controle cancele a operação de inserção ou edição. Esse evento geralmente é usado para interromper a operação de cancelamento.
ItemCommand Ocorre quando um usuário clica em um botão no controle ListView. Esse evento geralmente é usado para executar uma tarefa personalizada quando um botão é clicado no controle .
ItemCreated Ocorre quando um novo item é criado no ListView controle . Esse evento geralmente é usado para modificar o conteúdo de um item quando o item é criado.
ItemDataBound Ocorre quando um item de dados é associado a dados no ListView controle . Esse evento geralmente é usado para modificar o conteúdo de um item quando o item está associado aos dados.
ItemDeleted Ocorre quando um botão Excluir (um botão com sua CommandName propriedade definida como "Excluir") é clicado ou o DeleteItem método é chamado, depois que o ListView controle exclui o registro da fonte de dados. Esse evento geralmente é usado para marcar os resultados da operação de exclusão.
ItemDeleting Ocorre quando um botão Excluir (um botão com sua CommandName propriedade definida como "Excluir") é clicado ou o DeleteItem método é chamado, mas antes que o ListView controle exclua o registro da fonte de dados. Esse evento geralmente é usado para confirmar ou cancelar a operação de exclusão.
ItemEditing Ocorre quando um botão Editar (um botão com sua CommandName propriedade definida como "Editar") é clicado, mas antes que o ListView controle entre no modo de edição. Esse evento geralmente é usado para cancelar a operação de edição.
ItemInserted Ocorre quando um botão Inserir (um botão com sua CommandName propriedade definida como "Inserir") é clicado ou o InsertNewItem método é chamado, depois que o ListView controle insere o novo registro da fonte de dados. Esse evento geralmente é usado para marcar os resultados da operação de inserção.
ItemInserting Ocorre quando um botão Inserir (um botão com sua CommandName propriedade definida como "Insert") é clicado ou o InsertNewItem método é chamado, mas antes que o ListView controle insira o registro. Esse evento geralmente é usado para cancelar a operação de inserção ou alterar ou validar os valores do novo item.
ItemUpdated Ocorre quando um botão Atualizar (um botão com sua CommandName propriedade definida como "Update") é clicado ou o UpdateItem método é chamado, depois que o ListView controle atualiza o registro. Esse evento geralmente é usado para marcar os resultados da operação de atualização.
ItemUpdating Ocorre quando um botão Atualizar (um botão com sua CommandName propriedade definida como "Update") é clicado ou o UpdateItem método é chamado, mas antes que o ListView controle atualize o registro. Esse evento geralmente é usado para cancelar a operação de atualização ou alterar ou validar os valores do item editado.
LayoutCreated Ocorre quando o modelo LayoutTemplate é criado em um controle ListView. Esse evento geralmente é usado para executar uma tarefa depois que o modelo é criado.
PagePropertiesChanged Ocorre quando as propriedades da página são alteradas depois que o controle ListView define os novos valores.
PagePropertiesChanging Ocorre quando as propriedades da página de dados são alteradas, mas antes que o ListView controle defina os novos valores.
SelectedIndexChanged Ocorre quando um botão Selecionar (um botão com sua CommandName propriedade definida como "Selecionar") é clicado, depois que o ListView controle manipula a operação de seleção. Esse evento geralmente é usado para executar uma tarefa personalizada depois que um item é selecionado no controle .
SelectedIndexChanging Ocorre quando um botão Selecionar (um botão com sua CommandName propriedade definida como "Selecionar") é clicado, mas antes que o ListView controle manipule a operação de seleção. Esse evento geralmente é usado para cancelar a operação de seleção.
Sorted Ocorre quando um botão Classificar (um botão com sua CommandName propriedade definida como "Classificar") é clicado ou o Sort método é chamado, depois que o ListView controle manipula a operação de classificação. Esse evento normalmente é usado para executar uma tarefa personalizada depois que um usuário clica em um botão Classificar e os dados foram classificados.
Sorting Ocorre quando um botão Classificar (um botão com sua CommandName propriedade definida como "Classificar") é clicado ou o Sort método é chamado, mas antes que o ListView controle manipule a operação de classificação. Esse evento geralmente é usado para cancelar a operação de classificação ou para executar uma rotina de classificação personalizada.

Sintaxe declarativa

<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>

Construtores

ListView()

Inicializa uma nova instância da classe ListView.

Propriedades

AccessKey

Substitui a propriedade AccessKey. Não há suporte para a configuração dessa propriedade no controle ListView.

Adapter

Obtém o adaptador específico de navegador para o controle.

(Herdado de Control)
AlternatingItemTemplate

Obtém ou define o conteúdo personalizado para o item de dados alternados em um controle ListView.

AppRelativeTemplateSourceDirectory

Obtém ou define o diretório virtual relativo de aplicativo do objeto Page ou UserControl que contém este controle.

(Herdado de Control)
Attributes

Obtém a coleção de atributos arbitrários (somente para renderização) que não correspondem às propriedades do controle.

(Herdado de WebControl)
BackColor

Substitui a propriedade BackColor. Não há suporte para a configuração dessa propriedade no controle ListView.

BindingContainer

Obtém o controle que contém a vinculação de dados desse controle.

(Herdado de Control)
BorderColor

Substitui a propriedade BorderColor. Não há suporte para a configuração dessa propriedade no controle ListView.

BorderStyle

Substitui a propriedade BorderStyle. Não há suporte para a configuração dessa propriedade no controle ListView.

BorderWidth

Substitui a propriedade BorderWidth. Não há suporte para a configuração dessa propriedade no controle ListView.

ChildControlsCreated

Obtém um valor que indica se os controles filho do controle de servidor foram criados.

(Herdado de Control)
ClientID

Obtém a ID de controle de marcação HTML gerada pelo ASP.NET.

(Herdado de Control)
ClientIDMode

Obtém ou define o algoritmo usado para gerar o valor da propriedade ClientID.

(Herdado de Control)
ClientIDRowSuffix

Obtém ou define o nome do campo de dados cujo valor é usado para identificar exclusivamente cada linha de dados de um controle ListView quando a propriedade ClientIDMode é definida como Predictable.

ClientIDRowSuffixDataKeys

Obtém os valores de dados que são usados para identificar exclusivamente cada instância de um controle associado a dados quando o ASP.NET gera o valor ClientID.

ClientIDSeparator

Obtém um valor de caractere que representa o caractere separador usado na propriedade ClientID.

(Herdado de Control)
Context

Obtém o objeto HttpContext associado ao controle de servidor para a solicitação da Web atual.

(Herdado de Control)
Controls

Obtém um objeto ControlCollection que representa os controles filhos do controle ListView.

ControlStyle

Obtém o estilo de um controle de servidor Web. Essa propriedade é usada principalmente por desenvolvedores de controle.

(Herdado de WebControl)
ControlStyleCreated

Obtém um valor que indica se um objeto Style foi criado para a propriedade ControlStyle. Essa propriedade é usada principalmente por desenvolvedores de controle.

(Herdado de WebControl)
ConvertEmptyStringToNull

Obtém ou define um valor que indica se os valores de cadeia de caracteres vazia ("") são convertidos automaticamente em valores nulos quando o campo de dados é atualizado na fonte de dados.

CssClass

Substitui a propriedade CssClass. Não há suporte para a configuração dessa propriedade no controle ListView.

DataItemContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataItemContainer.

(Herdado de Control)
DataKeyNames

Obtém ou define uma matriz que contém os nomes dos campos de chave primária para os itens exibidos em um controle ListView.

DataKeys

Obtém uma coleção de objetos DataKey que representam o valor da chave de dados de cada item em um controle ListView.

DataKeysContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataKeysControl.

(Herdado de Control)
DataMember

Obtém ou define o nome da lista de dados ao qual o controle com limite de dados está associado, nos casos em que a fonte de dados contém mais de uma lista distinta de itens de dados.

(Herdado de DataBoundControl)
DataSource

Obtém ou define o objeto do qual o controle com limite de dados recupera sua lista de itens de dados.

(Herdado de BaseDataBoundControl)
DataSourceID

Obtém ou define a ID do controle do qual o controle associado a dados recupera sua lista de itens de dados.

(Herdado de DataBoundControl)
DataSourceObject

Obtém um objeto que implementa a interface IDataSource, que fornece acesso ao conteúdo de dados do objeto.

(Herdado de DataBoundControl)
DeleteMethod

Obtém ou define o nome do método a ser chamado para excluir dados.

DesignMode

Obtém um valor que indica se um controle está sendo usado em uma superfície de design.

(Herdado de Control)
EditIndex

Obtém ou define o índice do item que está sendo editado.

EditItem

Obtém o item que está em modo de edição em um controle ListView.

EditItemTemplate

Obtém ou define o conteúdo personalizado para o item no modo de edição.

EmptyDataTemplate

Obtém ou define o conteúdo definido pelo usuário para o modelo vazio renderizado quando um controle ListView é associado a uma fonte de dados que não contém registros.

EmptyItemTemplate

Obtém ou define o conteúdo definido pelo usuário para o item vazio renderizado em um controle ListView quando não há mais itens de dados a serem exibidos na última linha da página de dados atual.

Enabled

Obtém ou define um valor que indica se o controle do servidor Web está habilitado.

(Herdado de WebControl)
EnableModelValidation

Obtém ou define um valor que indica se um controle de validador vai manipular exceções que ocorrem durante as operações de inserção ou atualização.

EnablePersistedSelection

Obtém ou define um valor que indica se a seleção de linha persiste quando um usuário navega pelos dados em um controle associado a dados.

EnableTheming

Obtém ou define um valor que indica se os temas se aplicam a esse controle.

(Herdado de WebControl)
EnableViewState

Obtém ou define um valor que indica se o controle de servidor persiste seu estado de exibição e o estado de exibição de quaisquer controles filho que ele contém, para o cliente solicitante.

(Herdado de Control)
Events

Obtém uma lista de delegados de manipulador de eventos para o controle. Esta propriedade é somente para leitura.

(Herdado de Control)
Font

Substitui a propriedade Font. Esta propriedade não é compatível no controle ListView.

ForeColor

Substitui a propriedade ForeColor. Não há suporte para a configuração dessa propriedade no controle ListView.

GroupItemCount

Obtém ou define o número de itens a ser exibido por grupo em um controle ListView.

GroupPlaceholderID

Obtém ou define a ID do espaço reservado de grupo em um controle ListView.

GroupSeparatorTemplate

Obtém ou define o conteúdo definido pelo usuário para o separador entre grupos em um controle ListView.

GroupTemplate

Obtém ou define o conteúdo definido pelo usuário para o contêiner de grupo em um controle ListView.

HasAttributes

Obtém um valor que indica se o controle tem atributos definidos.

(Herdado de WebControl)
HasChildViewState

Obtém um valor que indica se os controles filho do controle de servidor atual têm alguma configuração de estado de exibição salva.

(Herdado de Control)
Height

Substitui a propriedade Height. Não há suporte para a configuração dessa propriedade no controle ListView.

ID

Obtém ou define o identificador programático atribuído ao controle de servidor.

(Herdado de Control)
IdSeparator

Obtém o caractere usado para separar identificadores de controle.

(Herdado de Control)
Initialized

Obtém um valor que indica se o controle associado a dados foi inicializado.

(Herdado de BaseDataBoundControl)
InsertItem

Obtém o item de inserção de um controle ListView.

InsertItemPosition

Obtém ou define o local do modelo InsertItemTemplate quando ele é renderizado como parte do controle ListView.

InsertItemTemplate

Obtém ou define o conteúdo personalizado para um item de inserção no controle de ListView.

InsertMethod

Obtém ou define o nome do método a ser chamado para inserir dados.

IsBoundUsingDataSourceID

Obtém um valor que indica se a propriedade DataSourceID foi definida.

(Herdado de BaseDataBoundControl)
IsChildControlStateCleared

Obtém um valor que indica se os controles contidos dentro deste controle têm estado de controle.

(Herdado de Control)
IsDataBindingAutomatic

Obtém um valor que indica se a associação de dados é automática.

(Herdado de BaseDataBoundControl)
IsEnabled

Obtém um valor que indica se o controle está habilitado.

(Herdado de WebControl)
IsTrackingViewState

Obtém um valor que indica se o controle de servidor está salvando alterações no estado de exibição.

(Herdado de Control)
IsUsingModelBinders

Obtém um valor que indica se o model binding está em uso.

IsUsingModelBinders

Obtém um valor que indica se o model binding está em uso.

(Herdado de DataBoundControl)
IsViewStateEnabled

Obtém um valor que indica se o estado de exibição está habilitado para esse controle.

(Herdado de Control)
ItemPlaceholderID

Obtém ou define a ID do espaço reservado do item em um controle ListView.

Items

Obtém uma coleção de objetos ListViewDataItem que representam os itens de dados da página de dados atual em um controle ListView.

ItemSeparatorTemplate

Obtém ou define o conteúdo personalizado para o separador entre os itens em um controle ListView.

ItemTemplate

Obtém ou define o conteúdo personalizado para o item de dados em um controle ListView.

ItemType

Obtém ou define o nome do tipo de item de dados para vinculação de dados com rigidez de tipos.

(Herdado de DataBoundControl)
LayoutTemplate

Obtém ou define o conteúdo personalizado do contêiner raiz em um controle ListView.

LoadViewStateByID

Obtém um valor que indica se o controle participa do carregamento do estado de exibição por ID em vez do índice.

(Herdado de Control)
MaximumRows

Obtém o número máximo de itens a exibir em uma única página do controle ListView.

NamingContainer

Obtém uma referência ao contêiner de nomenclatura do controle do servidor, que cria um namespace exclusivo para diferenciar entre os controles de servidor com o mesmo valor da propriedade ID.

(Herdado de Control)
Page

Obtém uma referência para a instância Page que contém o controle de servidor.

(Herdado de Control)
Parent

Obtém uma referência ao controle pai do controle de servidor na hierarquia de controle da página.

(Herdado de Control)
RenderingCompatibility

Obtém um valor que especifica a versão do ASP.NET com a qual o HTML renderizado será compatível.

(Herdado de Control)
RequiresDataBinding

Obtém ou define um valor que indica se o método DataBind() deve ser cancelado.

(Herdado de BaseDataBoundControl)
SelectArguments

Obtém um objeto DataSourceSelectArguments que o controle associado a dados usa ao recuperar dados de um controle de fonte de dados.

(Herdado de DataBoundControl)
SelectedDataKey

Obtém o valor de chave de dados do item selecionado em um controle ListView.

SelectedIndex

Obtém ou define o índice do item selecionado em um controle ListView.

SelectedItemTemplate

Obtém ou define o conteúdo personalizado para o item selecionado em um controle de ListView.

SelectedPersistedDataKey

Obtém ou define o valor de chave de dados para o item selecionado persistente em um controle associado a dados.

SelectedValue

Obtém o valor de chave de dados do item selecionado em um controle ListView.

SelectMethod

O nome do método a ser chamado para ler os dados.

(Herdado de DataBoundControl)
Site

Obtém informações sobre o contêiner que hospeda o controle atual quando renderizados em uma superfície de design.

(Herdado de Control)
SkinID

Obtém ou define a capa a ser aplicada ao controle.

(Herdado de WebControl)
SortDirection

Obtém a direção de classificação do campo ou dos campos que estão sendo classificados.

SortExpression

Obtém a expressão de classificação que é associada ao campo ou aos campos que estão sendo classificados.

StartRowIndex

Obtém o índice do primeiro registro exibido em uma página de dados no controle ListView.

Style

Obtém uma coleção de atributos de texto que serão renderizados como um atributo de estilo na marca externa do controle de servidor Web.

(Herdado de WebControl)
SupportsDisabledAttribute

Obtém um valor que indica se o controle deve definir o atributo disabled do elemento HTML renderizado para "desabilitado" quando a propriedade do controle IsEnabled é false.

(Herdado de BaseDataBoundControl)
TabIndex

Substitui a propriedade TabIndex. Não há suporte para a configuração dessa propriedade no controle ListView.

TagKey

Obtém o valor HtmlTextWriterTag que corresponde ao controle do servidor Web. Essa propriedade é usada principalmente por desenvolvedores de controle.

(Herdado de WebControl)
TagName

Obtém o nome da marca de controle. Essa propriedade é usada principalmente por desenvolvedores de controle.

(Herdado de WebControl)
TemplateControl

Obtém ou define uma referência ao modelo que contém este controle.

(Herdado de Control)
TemplateSourceDirectory

Obtém o diretório virtual do Page ou UserControl que contém o controle do servidor atual.

(Herdado de Control)
ToolTip

Substitui a propriedade ToolTip. Não há suporte para a configuração dessa propriedade no controle ListView.

UniqueID

Obtém o identificador exclusivo, qualificado segundo a hierarquia, para o controle de servidor.

(Herdado de Control)
UpdateMethod

Obtém ou define o nome do método a ser chamado para atualizar dados.

ValidateRequestMode

Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador para valores potencialmente perigosos.

(Herdado de Control)
ViewState

Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um controle de servidor em várias solicitações para a mesma página.

(Herdado de Control)
ViewStateIgnoresCase

Obtém um valor que indica se o objeto StateBag não diferencia maiúsculas de minúsculas.

(Herdado de Control)
ViewStateMode

Obtém ou define o modo de estado de exibição deste controle.

(Herdado de Control)
Visible

Obtém ou define um valor que indica se um controle de servidor é renderizado como uma interface do usuário na página.

(Herdado de Control)
Width

Substitui a propriedade Width. Não há suporte para a configuração dessa propriedade no controle ListView.

Métodos

AddAttributesToRender(HtmlTextWriter)

Adiciona atributos HTML e estilos que precisam ser renderizadas ao HtmlTextWriterTag especificado. Esse método é usado principalmente por desenvolvedores de controle.

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

Adiciona o controle especificado ao contêiner especificado.

AddedControl(Control, Int32)

Chamado após um controle filho ser adicionado à coleção Controls do objeto Control.

(Herdado de Control)
AddParsedSubObject(Object)

Notifica o controle de servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto ControlCollection do controle de servidor.

(Herdado de Control)
ApplyStyle(Style)

Copia os elementos não vazios do estilo especificado para o controle da Web, substituindo os elementos de estilo existentes no controle. Esse método é usado principalmente por desenvolvedores de controles.

(Herdado de WebControl)
ApplyStyleSheetSkin(Page)

Aplica as propriedades de estilo definidas na folha de estilos da página ao controle.

(Herdado de Control)
BeginRenderTracing(TextWriter, Object)

Inicia o rastreamento de tempo de design de dados de renderização.

(Herdado de Control)
BuildProfileTree(String, Boolean)

Reúne informações sobre o controle de servidor e as envia para a propriedade Trace para serem exibidas quando o rastreamento está habilitado para a página.

(Herdado de Control)
ClearCachedClientID()

Define o valor ClientID armazenado em cache como null.

(Herdado de Control)
ClearChildControlState()

Exclui as informações de estado de controle para os controles filho do controle de servidor.

(Herdado de Control)
ClearChildState()

Exclui as informações de estado de exibição e de estado de controle para todos os controles filho do controle de servidor.

(Herdado de Control)
ClearChildViewState()

Exclui as informações de estado de exibição para todos os controles filho do controle de servidor.

(Herdado de Control)
ClearEffectiveClientIDMode()

Define a propriedade ClientIDMode da instância de controle atual e de quaisquer controles filho para Inherit.

(Herdado de Control)
ConfirmInitState()

Define o estado inicializado do controle associado a dados.

(Herdado de BaseDataBoundControl)
CopyBaseAttributes(WebControl)

Copia as propriedades que não são encapsuladas pelo objeto Style de controle do servidor Web especificado ao controle de servidor Web do qual este método é chamado. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
CreateChildControls()

Cria a hierarquia de controle usada para renderizar o controle ListView, com base nos valores armazenados no estado de exibição.

CreateChildControls(IEnumerable, Boolean)

Cria a hierarquia de controles usada para renderizar o controle ListView usando a fonte de dados especificada.

CreateControlCollection()

Cria um novo objeto ControlCollection para manter os controles filho (literal e servidor) do controle do servidor.

(Herdado de Control)
CreateControlStyle()

Cria o estilo padrão do controle.

CreateDataItem(Int32, Int32)

Cria um item de dados no controle ListView.

CreateDataSourceSelectArguments()

Cria o objeto DataSourceSelectArguments que contém os argumentos passados para a fonte de dados.

CreateEmptyDataItem()

Cria o modelo EmptyDataTemplate no controle ListView.

CreateEmptyItem()

Cria um item vazio no controle ListView.

CreateInsertItem()

Cria um item de inserção no controle ListView.

CreateItem(ListViewItemType)

Cria um objeto ListViewItem com o tipo especificado.

CreateItemsInGroups(ListViewPagedDataSource, Boolean, InsertItemPosition, ArrayList)

Cria a hierarquia de controle ListView em grupos.

CreateItemsWithoutGroups(ListViewPagedDataSource, Boolean, InsertItemPosition, ArrayList)

Cria a hierarquia de controle ListView sem grupos.

CreateLayoutTemplate()

Cria o contêiner raiz no controle ListView.

CreateSuffixArrayList(ListViewPagedDataSource, ArrayList)

Cria uma matriz de sufixos para o ASP.NET usar ao gerar o valor ClientID.

DataBind()

Associa uma fonte de dados ao controle de servidor chamado e a todos os seus controles filho.

(Herdado de BaseDataBoundControl)
DataBind(Boolean)

Associa uma fonte de dados ao controle de servidor invocado e todos os seus controles filho com uma opção para gerar o evento DataBinding.

(Herdado de Control)
DataBindChildren()

Associa uma fonte de dados aos controles filho do controle do servidor.

(Herdado de Control)
DeleteItem(Int32)

Exclui o registro no índice especificado da fonte de dados.

Dispose()

Permite que um controle de servidor execute a limpeza final antes do lançamento da memória.

(Herdado de Control)
EndRenderTracing(TextWriter, Object)

Encerra o rastreamento de tempo de design de dados de renderização.

(Herdado de Control)
EnsureChildControls()

Determinará se o controle de servidor contiver controles filho. Se ele não contiver, ele criará controles filho.

(Herdado de Control)
EnsureDataBound()

Chamará o método DataBind() se a propriedade DataSourceID estiver definida e o controle associado a dados estiver marcado para exigir a associação.

(Herdado de BaseDataBoundControl)
EnsureID()

Cria um identificador para controles que não têm um identificador atribuído.

(Herdado de Control)
EnsureLayoutTemplate()

Garante que o conteúdo LayoutTemplate foi corretamente criado no controle ListView.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

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

Recupera os valores de cada campo declarados no item especificado e os armazena no objeto IOrderedDictionary especificado.

FindControl(String)

Procura o atual contêiner de nomenclatura de um controle de servidor com o parâmetro id especificado.

(Herdado de Control)
FindControl(String, Int32)

Procura o contêiner de nomenclatura atual para um controle de servidor com o id especificado e um inteiro especificado no parâmetro pathOffset, que auxilia na pesquisa. Você não deve substituir esta versão do método FindControl.

(Herdado de Control)
FindPlaceholder(String, Control)

Pesquisa no contêiner especificado um controle que tem o identificador especificado.

Focus()

Define o foco de entrada para um controle.

(Herdado de Control)
GetData()

Recupera um objeto DataSourceView que o controle com associação de dados usa para executar operações de dados.

(Herdado de DataBoundControl)
GetDataSource()

Recupera a interface IDataSource à qual o controle associado a dados está associado, se houver.

(Herdado de DataBoundControl)
GetDesignModeState()

Obtém os dados de tempo de design para um controle.

(Herdado de Control)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetRouteUrl(Object)

Obtém a URL que corresponde a um conjunto de parâmetros de rota.

(Herdado de Control)
GetRouteUrl(RouteValueDictionary)

Obtém a URL que corresponde a um conjunto de parâmetros de rota.

(Herdado de Control)
GetRouteUrl(String, Object)

Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota.

(Herdado de Control)
GetRouteUrl(String, RouteValueDictionary)

Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota.

(Herdado de Control)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
GetUniqueIDRelativeTo(Control)

Retorna a parte prefixada da propriedade UniqueID do controle especificado.

(Herdado de Control)
HasControls()

Determina se o controle de servidor contém algum controle filho.

(Herdado de Control)
HasEvents()

Retorna um valor que indica se os eventos são registrados para o controle ou qualquer controle filho.

(Herdado de Control)
InsertNewItem(Boolean)

Insere o registro atual na fonte de dados.

InstantiateEmptyDataTemplate(Control)

Popula o objeto Control especificado usando os controles filho contidos no modelo EmptyDataTemplate.

InstantiateEmptyItemTemplate(Control)

Popula o objeto Control especificado usando os controles filho contidos no modelo EmptyItemTemplate.

InstantiateGroupSeparatorTemplate(Control)

Popula o objeto Control especificado usando os controles filho contidos no modelo GroupSeparatorTemplate.

InstantiateGroupTemplate(Control)

Popula o objeto Control especificado usando os controles filho contidos no modelo GroupTemplate.

InstantiateInsertItemTemplate(Control)

Popula o objeto Control especificado usando os controles filho contidos no modelo InsertItemTemplate.

InstantiateItemSeparatorTemplate(Control)

Popula o objeto Control especificado usando os controles filho contidos no modelo ItemSeparatorTemplate.

InstantiateItemTemplate(Control, Int32)

Popula o objeto Control especificado usando controles filho de um dos modelos de controle ListView.

IsLiteralContent()

Determina se o controle de servidor contém apenas o conteúdo literal.

(Herdado de Control)
LoadControlState(Object)

Carrega o estado das propriedades no controle ListView que devem ser persistentes, mesmo quando a propriedade EnableViewState é definida como false.

LoadViewState(Object)

Carrega o estado de exibição salvo anteriormente do controle ListView.

MapPathSecure(String)

Recupera o caminho físico para o qual um caminho virtual é mapeado, relativo ou virtual.

(Herdado de Control)
MarkAsDataBound()

Define o estado do controle em estado de exibição como associado com êxito aos dados.

(Herdado de DataBoundControl)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
MergeStyle(Style)

Copia os elementos não vazios do estilo especificado para o controle da Web, mas não substituirá os elementos de estilo existentes do controle. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
OnBubbleEvent(Object, EventArgs)

Determina se um evento para o controle ListView deve ser tratado.

OnCreatingModelDataSource(CreatingModelDataSourceEventArgs)

Aciona o evento CreatingModelDataSource.

(Herdado de DataBoundControl)
OnDataBinding(EventArgs)

Aciona o evento DataBinding.

(Herdado de Control)
OnDataBound(EventArgs)

Aciona o evento DataBound.

(Herdado de BaseDataBoundControl)
OnDataPropertyChanged()

Associa novamente o controle associado a dados a seus dados após a alteração de uma das propriedades de identificação da fonte de dados base.

(Herdado de DataBoundControl)
OnDataSourceViewChanged(Object, EventArgs)

Aciona o evento DataSourceViewChanged.

(Herdado de DataBoundControl)
OnInit(EventArgs)

Aciona o evento Init.

OnItemCanceling(ListViewCancelEventArgs)

Aciona o evento ItemCanceling.

OnItemCommand(ListViewCommandEventArgs)

Aciona o evento ItemCommand.

OnItemCreated(ListViewItemEventArgs)

Aciona o evento ItemCreated.

OnItemDataBound(ListViewItemEventArgs)

Aciona o evento ItemDataBound.

OnItemDeleted(ListViewDeletedEventArgs)

Aciona o evento ItemDeleted.

OnItemDeleting(ListViewDeleteEventArgs)

Aciona o evento ItemDeleting.

OnItemEditing(ListViewEditEventArgs)

Aciona o evento ItemEditing.

OnItemInserted(ListViewInsertedEventArgs)

Aciona o evento ItemInserted.

OnItemInserting(ListViewInsertEventArgs)

Aciona o evento ItemInserting.

OnItemUpdated(ListViewUpdatedEventArgs)

Aciona o evento ItemUpdated.

OnItemUpdating(ListViewUpdateEventArgs)

Aciona o evento ItemUpdating.

OnLayoutCreated(EventArgs)

Aciona o evento LayoutCreated.

OnLoad(EventArgs)

Manipula o evento Load.

(Herdado de DataBoundControl)
OnPagePreLoad(Object, EventArgs)

Define o estado inicializado do controle associado a dados antes do carregamento do controle.

(Herdado de DataBoundControl)
OnPagePropertiesChanged(EventArgs)

Aciona o evento PagePropertiesChanged.

OnPagePropertiesChanging(PagePropertiesChangingEventArgs)

Aciona o evento PagePropertiesChanging.

OnPreRender(EventArgs)

Manipula o evento PreRender.

(Herdado de BaseDataBoundControl)
OnSelectedIndexChanged(EventArgs)

Aciona o evento SelectedIndexChanged.

OnSelectedIndexChanging(ListViewSelectEventArgs)

Aciona o evento SelectedIndexChanging.

OnSorted(EventArgs)

Aciona o evento Sorted.

OnSorting(ListViewSortEventArgs)

Aciona o evento Sorting.

OnTotalRowCountAvailable(PageEventArgs)

Aciona o evento IPageableItemContainer.TotalRowCountAvailable.

OnUnload(EventArgs)

Aciona o evento Unload.

(Herdado de Control)
OpenFile(String)

Obtém um Stream usado para ler um arquivo.

(Herdado de Control)
PerformDataBinding(IEnumerable)

Associa o controle de ListView à fonte de dados especificada.

PerformSelect()

Recupera dados da fonte de dados associada.

RaiseBubbleEvent(Object, EventArgs)

Atribui quaisquer fontes de evento e suas informações para o pai do controle.

(Herdado de Control)
RemovedControl(Control)

Chamado após um controle filho ser removido da coleção Controls do objeto Control.

(Herdado de Control)
RemoveItems()

Exclui todos os controles filho em um contêiner de item ou de grupo do controle ListView.

Render(HtmlTextWriter)

Renderiza o conteúdo do controle de servidor Web no navegador do cliente usando o objeto HtmlTextWriter especificado.

RenderBeginTag(HtmlTextWriter)

Renderiza a marca de abertura HTML do controle para o gravador especificado. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
RenderChildren(HtmlTextWriter)

Gera o conteúdo dos filhos de um controle de servidor para um objeto HtmlTextWriter fornecido, que grava o conteúdo a ser renderizado no cliente.

(Herdado de Control)
RenderContents(HtmlTextWriter)

Renderiza o conteúdo do controle no gravador especificado. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
RenderControl(HtmlTextWriter)

Gera o conteúdo do controle de servidor para um objeto HtmlTextWriter fornecido e armazena informações de rastreamento sobre o controle caso o rastreamento esteja habilitado.

(Herdado de Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Gera o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido.

(Herdado de Control)
RenderEndTag(HtmlTextWriter)

Renderiza a marca de fechamento HTML do controle para o gravador especificado. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
ResolveAdapter()

Obtém o adaptador de controle responsável por renderizar o controle especificado.

(Herdado de Control)
ResolveClientUrl(String)

Obtém uma URL que pode ser usada pelo navegador.

(Herdado de Control)
ResolveUrl(String)

Converte uma URL em uma que possa ser usada no cliente solicitante.

(Herdado de Control)
SaveControlState()

Salva o estado das propriedades no controle ListView que devem ser persistentes, mesmo quando a propriedade EnableViewState é definida como false.

SaveViewState()

Salva o estado de exibição atual do controle ListView.

SelectItem(Int32)

Seleciona o item que está em modo de edição em um controle ListView.

SetDesignModeState(IDictionary)

Define os dados de tempo de design para um controle.

(Herdado de Control)
SetEditItem(Int32)

Define o item especificado no modo de edição em um controle ListView.

SetPageProperties(Int32, Int32, Boolean)

Define as propriedades de uma página de dados no controle ListView.

SetRenderMethodDelegate(RenderMethod)

Atribui um delegado do manipulador de eventos para renderizar o controle de servidor e seu conteúdo em seu controle pai.

(Herdado de Control)
SetTraceData(Object, Object)

Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando a chave e o valor de dados de rastreamento.

(Herdado de Control)
SetTraceData(Object, Object, Object)

Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando o objeto rastreado, a chave e o valor de dados de rastreamento.

(Herdado de Control)
Sort(String, SortDirection)

Classifica o controle ListView, dependendo da expressão e direção de classificação especificadas.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)
TrackViewState()

Faz com que as alterações de estado de exibição no controle sejam controladas, de modo que possam ser armazenadas no objeto StateBag do controle.

(Herdado de DataBoundControl)
UpdateItem(Int32, Boolean)

Atualiza o registro no índice especificado na fonte de dados.

ValidateDataSource(Object)

Verifica se o objeto ao qual um controle associado a dados está associado é um objeto com o qual ele pode trabalhar.

(Herdado de DataBoundControl)

Eventos

CallingDataMethods

Ocorre quando os métodos de dados estão sendo chamados.

(Herdado de DataBoundControl)
CreatingModelDataSource

Ocorre quando o objeto ModelDataSource está sendo criado.

(Herdado de DataBoundControl)
DataBinding

Ocorre quando o controle de servidor é associado a uma fonte de dados.

(Herdado de Control)
DataBound

Ocorre após o controle de servidor ser associado a uma fonte de dados.

(Herdado de BaseDataBoundControl)
Disposed

Ocorre quando um controle de servidor é liberado da memória, que é o último estágio do ciclo de vida de controle de servidor quando uma página ASP.NET é solicitada.

(Herdado de Control)
Init

Ocorre quando o controle de servidor é inicializado, que é a primeira etapa do ciclo de vida.

(Herdado de Control)
ItemCanceling

Ocorre quando uma operação de cancelamento é solicitada, mas antes de o controle ListView cancelar a operação de inserção ou edição.

ItemCommand

Ocorre quando se clica em um botão em um controle ListView.

ItemCreated

Ocorre quando um item é criado em um controle ListView.

ItemDataBound

Ocorre quando um item de dados é associado a dados em um controle ListView.

ItemDeleted

Ocorre quando uma operação de exclusão é solicitada, depois que o controle ListView exclui o item.

ItemDeleting

Ocorre quando uma operação de exclusão é solicitada, mas antes do controle ListView excluir o item.

ItemEditing

Ocorre quando uma operação de edição é solicitada, mas antes que o item ListView seja colocado no modo de edição.

ItemInserted

Ocorre quando uma operação de inserção é solicitada, após o controle ListView ter inserido o item na fonte de dados.

ItemInserting

Ocorre quando uma operação de inserção é solicitada, mas antes de o controle ListView realizar a inserção.

ItemUpdated

Ocorre quando uma operação de atualização é solicitada, depois que o controle ListView atualiza o item.

ItemUpdating

Ocorre quando uma operação de atualização é solicitada, mas antes de o controle ListView atualizar o item.

LayoutCreated

Ocorre quando o modelo LayoutTemplate é criado em um controle ListView.

Load

Ocorre quando o controle de servidor é carregado no objeto Page.

(Herdado de Control)
PagePropertiesChanged

Ocorre quando as propriedades da página são alteradas depois que o controle ListView define os novos valores.

PagePropertiesChanging

Ocorre quando as propriedades da página são alteradas, mas antes que o controle ListView defina os novos valores.

PreRender

Ocorre depois que o objeto Control é carregado, mas antes da renderização.

(Herdado de Control)
SelectedIndexChanged

Ocorre quando o botão de seleção de um item é clicado, após o controle ListView manipular a operação de seleção.

SelectedIndexChanging

Ocorre quando o botão Seleção de um item é clicado, mas antes do controle ListView manipular a operação de seleção.

Sorted

Ocorre quando uma operação de classificação é solicitada, depois de o controle ListView manipular a operação de classificação.

Sorting

Ocorre quando uma operação de classificação é solicitada, mas antes de o controle ListView manipular a operação de classificação.

Unload

Ocorre quando o controle de servidor é descarregado da memória.

(Herdado de Control)

Implantações explícitas de interface

IAttributeAccessor.GetAttribute(String)

Obtém um atributo do controle da Web com o nome especificado.

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

Define um atributo do controle da Web para o nome e o valor especificados.

(Herdado de WebControl)
IControlBuilderAccessor.ControlBuilder

Para obter uma descrição desse membro, confira ControlBuilder.

(Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()

Para obter uma descrição desse membro, confira GetDesignModeState().

(Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Para obter uma descrição desse membro, confira SetDesignModeState(IDictionary).

(Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Para obter uma descrição desse membro, confira SetOwnerControl(Control).

(Herdado de Control)
IControlDesignerAccessor.UserData

Para obter uma descrição desse membro, confira UserData.

(Herdado de Control)
IDataBindingsAccessor.DataBindings

Para obter uma descrição desse membro, confira DataBindings.

(Herdado de Control)
IDataBindingsAccessor.HasDataBindings

Para obter uma descrição desse membro, confira HasDataBindings.

(Herdado de Control)
IDataBoundControl.DataKeyNames

Obtém ou define uma matriz que contém os nomes dos campos de chave primária dos itens exibidos no controle associado a dados.

IDataBoundControl.DataMember

Obtém ou define o nome da lista de dados ao qual o controle associado a dados está associado quando a fonte de dados contém mais de uma lista distinta de itens de dados.

IDataBoundControl.DataSource

Obtém ou define o objeto do qual um controle com limite de dados recupera sua lista de itens de dados.

IDataBoundControl.DataSourceID

Obtém ou define a ID do controle de fonte de dados do qual um controle associado a dados recupera sua lista de itens de dados.

IDataBoundControl.DataSourceObject

Obtém um objeto que implementa a interface IDataSource, que fornece acesso ao conteúdo de dados do objeto.

IDataBoundListControl.ClientIDRowSuffix

Obtém o nome do campo de dados cujo valor é usado para identificar exclusivamente cada linha de dados de um controle ListView quando a propriedade ClientIDMode é definida como Predictable.

IDataBoundListControl.DataKeys

Obtém uma coleção de valores de chave de dados que representam cada linha em um controle associado a dados.

IDataBoundListControl.EnablePersistedSelection

Obtém ou define o valor que especifica se uma linha selecionada persiste quando um usuário navega pelos dados em um controle associado a dados.

IDataBoundListControl.SelectedDataKey

Obtém o objeto de chave de dados que contém o valor de chave de dados para a linha selecionada em um controle associado a dados.

IDataBoundListControl.SelectedIndex

Obtém ou define o índice da linha selecionada em um controle associado a dados.

IDataKeysControl.ClientIDRowSuffixDataKeys

Obtém uma coleção dos valores de dados que são usados para identificar exclusivamente cada instância de um controle associado a dados quando o ASP.NET gera o valor ClientID.

IExpressionsAccessor.Expressions

Para obter uma descrição desse membro, confira Expressions.

(Herdado de Control)
IExpressionsAccessor.HasExpressions

Para obter uma descrição desse membro, confira HasExpressions.

(Herdado de Control)
IPageableItemContainer.MaximumRows

Para obter uma descrição desse membro, confira MaximumRows.

IPageableItemContainer.SetPageProperties(Int32, Int32, Boolean)

Para obter uma descrição desse membro, confira SetPageProperties(Int32, Int32, Boolean).

IPageableItemContainer.StartRowIndex

Para obter uma descrição desse membro, confira StartRowIndex.

IPageableItemContainer.TotalRowCountAvailable

Para obter uma descrição desse membro, confira TotalRowCountAvailable.

IParserAccessor.AddParsedSubObject(Object)

Para obter uma descrição desse membro, confira AddParsedSubObject(Object).

(Herdado de Control)
IPersistedSelector.DataKey

Obtém ou define o valor de chave de dados para o registro selecionado em um controle associado a dados.

Métodos de Extensão

EnablePersistedSelection(BaseDataBoundControl)
Obsoleto.

Permite que a seleção seja persistida nos controles de dados que dão suporte à seleção e à paginação.

FindDataSourceControl(Control)

Retorna a fonte de dados associada ao controle de dados do controle especificado.

FindFieldTemplate(Control, String)

Retorna o modelo do campo para a coluna especificada no contêiner de nomenclatura do controle especificado.

FindMetaTable(Control)

Retorna o objeto metatable para o controle que contém dados.

GetDefaultValues(INamingContainer)

Obtém a coleção de valores padrão para o controle de dados especificado.

GetMetaTable(INamingContainer)

Obtém os metadados de tabela para o controle de dados especificado.

SetMetaTable(INamingContainer, MetaTable)

Define os metadados de tabela para o controle de dados especificado.

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

Define os metadados de tabela e o mapeamento de valores padrão para o controle de dados especificado.

SetMetaTable(INamingContainer, MetaTable, Object)

Define os metadados de tabela e o mapeamento de valores padrão para o controle de dados especificado.

TryGetMetaTable(INamingContainer, MetaTable)

Determina se os metadados da tabela estão disponíveis.

EnableDynamicData(INamingContainer, Type)

Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.

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

Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.

EnableDynamicData(INamingContainer, Type, Object)

Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.

Aplica-se a

Confira também