ListView Classe

Definição

Apresenta os valores de uma fonte de dados utilizando modelos definidos pelo utilizador. O ListView controlo permite aos utilizadores selecionar, ordenar, eliminar, editar e inserir registos.

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 seguinte mostra como usar o ListView controlo para exibir registos de uma base de dados utilizando uma tabela HTML. Os valores são recuperados usando um LinqDataSource controlo.

<%@ 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 seguinte mostra como usar o ListView controlo para mostrar valores num layout de fluxo usando o div elemento. Os valores são recuperados usando um SqlDataSource controlo.

<%@ 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 seguinte mostra como usar o ListView controlo para inserir, eliminar e atualizar registos.

Importante

Este exemplo tem uma caixa de texto que aceita a entrada do utilizador, o que constitui uma potencial ameaça à segurança. Por defeito, as páginas Web do ASP.NET validam que a entrada do utilizador não inclui elementos de script ou HTML. Para mais informações, consulte Visão Geral dos Exploits de Scripts.

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

Observações

Neste artigo:

Introdução

O ListView controlo é usado para mostrar os valores de uma fonte de dados. Assemelha-se ao GridView controlo, exceto que apresenta os dados usando modelos definidos pelo utilizador em vez de campos de linhas. Criar os seus próprios modelos dá-lhe mais flexibilidade no controlo de como os dados são apresentados.

O ListView controlo suporta as seguintes funcionalidades:

  • Suporte para ligação a controlos de fonte de dados como SqlDataSource, LinqDataSource, e ObjectDataSource.
  • Aparência personalizável através de modelos e estilos definidos pelo utilizador.
  • Capacidades integradas de ordenação.
  • Funcionalidades integradas de atualização e eliminação.
  • Capacidades de inserção integradas.
  • Suporte para capacidades de paginação através de um DataPager controlo.
  • Capacidades integradas de seleção de itens.
  • Acesso programático ao ListView modelo de objetos para definir dinamicamente propriedades, gerir eventos, e assim por diante.
  • Múltiplos campos de chave.

Para saber mais sobre outros controlos ligados a dados disponíveis em ASP.NET, consulte Data-Bound Controlos do Servidor Web.

Templates

Para que o ListView controlo mostre conteúdo, deve criar modelos para diferentes partes do controlo. O ItemTemplate é obrigatório. Todos os outros modelos são opcionais. A LayoutTemplate propriedade não é obrigatória.

No entanto, deve criar um modelo para o modo em que o controlo está configurado. Por exemplo, um ListView controlo que suporta a inserção de registos deve ter um InsertItemTemplate template definido. A tabela seguinte lista os modelos que pode criar para o ListView controlo.

Tipo de modelo Descrição
LayoutTemplate O template raiz que define um objeto contentor, como um table, div, ou span elemento, que conterá o conteúdo definido no ItemTemplate ou GroupTemplate template. Também pode conter um DataPager objeto.
ItemTemplate Define o conteúdo vinculado aos dados a mostrar para itens individuais.
ItemSeparatorTemplate Define o conteúdo a renderizar entre itens individuais.
GroupTemplate Define um objeto contentor, como uma linha de tabela (tr), , ou div elemento, que conterá o conteúdo definido nos span templates e.ItemTemplateEmptyItemTemplate O número de itens que são exibidos num grupo é especificado pela GroupItemCount propriedade.
GroupSeparatorTemplate Define o conteúdo a renderizar entre grupos de itens.
EmptyItemTemplate Define o conteúdo a renderizar para um item vazio quando um GroupTemplate modelo é utilizado. Por exemplo, se a GroupItemCount propriedade estiver definida para 5, e o número total de itens devolvidos da fonte de dados for 8, o último grupo de dados apresentado pelo ListView controlo conterá três itens conforme especificado pelo ItemTemplate modelo e dois itens conforme especificado pelo EmptyItemTemplate modelo.
EmptyDataTemplate Define o conteúdo a renderizar se a fonte de dados não devolver dados.
SelectedItemTemplate Define o conteúdo a renderizar para o elemento de dados selecionado para diferenciar o item selecionado dos outros itens.
AlternatingItemTemplate Define o conteúdo a renderizar para itens alternados, de modo a facilitar a distinção entre itens consecutivos.
EditItemTemplate Define o conteúdo a renderizar quando um item está a ser editado. O EditItemTemplate modelo é renderizado em vez do ItemTemplate modelo do elemento de dados que está a ser editado.
InsertItemTemplate Define o conteúdo a renderizar para inserir um item. O InsertItemTemplate modelo é renderizado em vez de um ItemTemplate modelo no início ou no final dos itens que são apresentados pelo ListView controlo. Pode especificar onde o InsertItemTemplate template é renderizado usando a InsertItemPosition propriedade do ListView controlo.

Para mostrar o valor de um campo num modelo como ItemTemplate, utiliza-se uma expressão de ligação de dados. Para mais informações sobre expressões de ligação de dados, consulte Data-Binding Visão Geral das Expressões.

Para associar controlos de entrada nos EditItemTemplate templates and InsertItemTemplate aos campos de uma fonte de dados, pode usar expressões de ligação bidirecional. Isto permite que o ListView controlo extraia automaticamente os valores do controlo de entrada para uma operação de atualização ou inserção. Expressões de ligação bidirecional também permitem controlos de entrada em e EditItemTemplate para mostrar automaticamente os valores originais dos campos. Para mais informações sobre expressões de ligação bidirecional, veja Binding to Databases.

Ligação a uma Fonte de Dados

Pode associar o ListView controlo a um controlo de fonte de dados (como o SqlDataSource controlo ou ObjectDataSource controlo) ou a qualquer coleção de fontes 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ções. Use um dos seguintes métodos para associar o ListView controlo ao tipo de fonte de dados apropriado:

  • Para ligar a um controlo de fonte de dados, defina a DataSourceID propriedade do ListView controlo para o ID valor do controlo de fonte de dados. O ListView controlo liga-se automaticamente ao controlo de fonte de dados especificado e pode tirar partido das capacidades do controlo de fonte de dados para realizar funcionalidades de ordenação, inserção, atualização, eliminação e paginação. Este é o método preferido para vincular dados.

  • Para ligar a uma fonte de dados que implemente a System.Collections.IEnumerable interface, defina programaticamente a DataSource propriedade do ListView controlo para a fonte de dados e depois chame o DataBind método. Quando utiliza esta técnica, o controlo ListView não fornece funcionalidade incorporada de ordenação, atualização, eliminação e paginação. Deve fornecer esta funcionalidade utilizando o evento apropriado.

Para mais informações sobre ligação de dados, consulte ASP.NET Data Access Content Map.

Note

O ListView controlo pode ser usado para mostrar a entrada do utilizador, que pode incluir scripts de cliente maliciosos. Verifique qualquer informação enviada por um cliente para script executável, instruções SQL ou outro código antes de a apresentar na aplicação. Recomendamos fortemente que os valores sejam codificados em HTML sempre que possível antes de serem exibidos neste controlo. O ASP.NET fornece uma funcionalidade de validação de pedidos de entrada para ajudar a blocar scripts e HTML na entrada do utilizador. Também pode usar os controlos do servidor de validação para verificar a entrada do utilizador. Para mais informações, consulte Introdução aos Controlos de Validação.

Operações de Dados

Quando o ListView controlo está ligado a um controlo de fonte de dados, este ListView pode tirar partido das capacidades do controlo de fonte de dados e fornecer funcionalidades automáticas de ordenação, inserção, atualização e eliminação.

Note

O ListView controlo pode fornecer suporte para ordenar, inserir, atualizar e eliminar com outros tipos de fontes de dados. No entanto, para implementar estas operações, é necessário criar código num gestor de eventos apropriado.

Como o ListView controlo utiliza templates, não oferece uma forma de gerar automaticamente botões para realizar operações, atualizar, eliminar, inserir, ordenar ou selecionar. Deve incluir manualmente estes botões no modelo apropriado. O ListView controlo reconhece certos botões cuja CommandName propriedade está definida para um valor específico. A tabela seguinte lista os botões que o ListView controlo reconhece e as suas funções.

Botão Valor CommandName Descrição
Cancelar Cancelar Cancela uma operação de edição ou inserção. Eleva o ItemCanceling evento.
Eliminar "Apagar" Apaga o registo atual da fonte de dados. Aumenta os ItemDeleted eventos e ItemDeleting eventos.
Selecionar "Selecionar" Define a SelectedIndex propriedade para o DisplayIndex valor do imóvel correspondente ao item. Renderiza o SelectedItemTemplate modelo do item. Aumenta os SelectedIndexChanging eventos e SelectedIndexChanged eventos.
Editar "Editar" Coloca o item em modo de edição. Renderiza o EditItemTemplate modelo do item. Eleva o ItemEditing evento.
Inserir "Inserir" Insere os valores vinculados do InsertItemTemplate template na fonte de dados. Aumenta os ItemInserting eventos e ItemInserted eventos.
Atualização "Atualização" Atualiza o registo atual na fonte de dados com os valores vinculados do EditItemTemplate modelo. Aumenta os ItemUpdating eventos e ItemUpdated eventos.
Sort "Sort" Ordena as colunas listadas na CommandArgument propriedade do botão. Aumenta os Sorting eventos e Sorted eventos.

Ao contrário do botão Delete (que elimina imediatamente o elemento de dados atual), quando o botão Editar é clicado, o ListView controlo mostra o item atual em modo de edição. No modo de edição, o conteúdo contido na EditItemTemplate propriedade é apresentado para o elemento de dados atual. Normalmente, no modelo de editar item, o botão Editar é substituído por um botão Atualizar e um botão Cancelar. Controlos de entrada apropriados para o tipo de dado do campo (como a TextBox ou CheckBox controlo) também costumam mostrar o valor de um campo para o utilizador modificar. Clicar no botão Atualizar atualiza o registo na fonte de dados, e clicar no botão Cancelar cancela a operação de edição.

A funcionalidade de inserção é ativada quando a InsertItemPosition propriedade está definida como FirstItem ou LastItem. Esta propriedade define onde o InsertItemTemplate template é renderizado para o item inserido. O modelo de inserção de item normalmente inclui um botão Inserir e um botão Cancelar, e controlos de entrada vazios são exibidos para que os utilizadores possam inserir os valores do novo registo. Clicar no botão Inserir insere o registo na fonte de dados, e clicar no botão Cancelar apaga todos os campos.

Ordenação

O ListView controlo permite aos utilizadores ordenar os itens clicando no botão Ordenar. A funcionalidade de ordenação está definida na CommandArgument propriedade do botão que contém as colunas a ordenar.

Paging

Em vez de mostrar todos os registos da fonte de dados ao mesmo tempo, o ListView controlo pode dividir os registos em páginas. Para ativar a paginação, associe um DataPager controlo ao ListView controlo. Depois insere um DataPager controlo dentro do LayoutTemplate modelo. Alternativamente, se o controlo DataPager estiver fora do ListView controlo, define a PagedControlID propriedade para o ID do ListView controlo.

Eventos

A tabela seguinte lista os eventos suportados pelo ListView controlo.

Evento Descrição
ItemCanceling Ocorre quando o botão Cancelar (um botão com CommandName a propriedade definida como "Cancelar") é clicado, mas antes do ListView controlo cancelar a operação de inserção ou edição. Este evento é frequentemente usado para parar a operação de cancelamento.
ItemCommand Ocorre quando um botão é clicado no ListView controlo. Este evento é frequentemente usado para realizar uma tarefa personalizada quando um botão é pressionado no controlo.
ItemCreated Ocorre quando um novo item é criado no ListView controlo. Este evento é frequentemente usado para modificar o conteúdo de um item quando este é criado.
ItemDataBound Ocorre quando um elemento de dados está ligado a dados no ListView controlo. Este evento é frequentemente usado para modificar o conteúdo de um item quando este está ligado a dados.
ItemDeleted Ocorre quando um botão Delete (um botão com CommandName a propriedade definida para "Eliminar") é clicado ou o DeleteItem método é chamado, após o ListView controlo eliminar o registo da fonte de dados. Este evento é frequentemente usado para verificar os resultados da operação de eliminação.
ItemDeleting Ocorre quando um botão Delete (um botão com CommandName a propriedade definida para "Delete") é clicado ou o DeleteItem método é chamado, mas antes de o ListView controlo eliminar o registo da fonte de dados. Este evento é frequentemente usado para confirmar ou cancelar a operação de eliminação.
ItemEditing Ocorre quando um botão de Editar (um botão com CommandName a propriedade definida para "Editar") é clicado, mas antes do ListView controlo entrar no modo de edição. Este evento é frequentemente usado para cancelar a operação de edição.
ItemInserted Ocorre quando um botão Insert (um botão com CommandName a propriedade definida como "Insert") é clicado ou o InsertNewItem método é chamado, após o ListView controlo inserir o novo registo da fonte de dados. Este evento é frequentemente usado para verificar os resultados da operação de inserção.
ItemInserting Ocorre quando um botão Insert (um botão com CommandName a propriedade definida para "Insert") é clicado ou o InsertNewItem método é chamado, mas antes do controlo ListView inserir o registo. Este evento é frequentemente 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 CommandName a propriedade definida para "Atualizar") é clicado ou o UpdateItem método é chamado, após o controlo ListView atualizar o registo. Este evento é frequentemente usado para verificar os resultados da operação de atualização.
ItemUpdating Ocorre quando um botão Atualizar (um botão com CommandName a propriedade definida como "Atualizar") é clicado ou o UpdateItem método é chamado, mas antes de o ListView controlo atualizar o registo. Este evento é frequentemente usado para cancelar a operação de atualização ou alterar ou validar os valores do item editado.
LayoutCreated Ocorre quando o LayoutTemplate template é criado num ListView controlo. Este evento é frequentemente usado para realizar uma tarefa após a criação do modelo.
PagePropertiesChanged Ocorre quando as propriedades da página mudam, depois de o controlo ListView definir os novos valores.
PagePropertiesChanging Ocorre quando as propriedades da página de dados mudam, mas antes do controlo ListView definir os novos valores.
SelectedIndexChanged Ocorre quando um botão Select (um botão com CommandName a propriedade definida para "Select") é clicado, depois de o ListView controlo tratar da operação select. Este evento é frequentemente usado para realizar uma tarefa personalizada após um item ser selecionado no controlo.
SelectedIndexChanging Ocorre quando um botão Select (um botão com CommandName a propriedade definida para "Select") é clicado, mas antes do controlo ListView tratar da operação de seleção. Este evento é frequentemente usado para cancelar a operação de seleção.
Sorted Ocorre quando um botão de Ordenar (um botão com CommandName a propriedade definida para "Ordenar") é clicado ou o Sort método é chamado, depois de o ListView controlo tratar da operação de ordenação. Este evento é normalmente utilizado para realizar uma tarefa personalizada após o utilizador clicar num botão Ordenar e os dados terem sido organizados.
Sorting Ocorre quando um botão de Ordenar (um botão com CommandName a propriedade definida como "Ordenar") é clicado ou o Sort método é chamado, mas antes do ListView controlo tratar da operação de ordenação. Este evento é frequentemente usado para cancelar a operação de ordenação ou para executar uma rotina de ordenaçã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

Name Description
ListView()

Inicializa uma nova instância da ListView classe.

Propriedades

Name Description
AccessKey

Sobrepõe-se à propriedade AccessKey . Definir esta propriedade não é suportado pelo ListView controlo.

Adapter

Recebe o adaptador específico do navegador para o controlo.

(Herdado de Control)
AlternatingItemTemplate

Obtém ou define o conteúdo personalizado para o item de dados alternado num ListView controlo.

AppRelativeTemplateSourceDirectory

Obtém ou define o diretório virtual relativo à aplicação do Page objeto ou UserControl que contém este controlo.

(Herdado de Control)
Attributes

Obtém a coleção de atributos arbitrários (apenas para renderização) que não correspondem a propriedades no controlo.

(Herdado de WebControl)
BackColor

Sobrepõe-se à propriedade BackColor . Definir esta propriedade não é suportado pelo ListView controlo.

BindingContainer

Obtém o controlo que contém a ligação de dados desse controlo.

(Herdado de Control)
BorderColor

Sobrepõe-se à propriedade BorderColor . Definir esta propriedade não é suportado pelo ListView controlo.

BorderStyle

Sobrepõe-se à propriedade BorderStyle . Definir esta propriedade não é suportado pelo ListView controlo.

BorderWidth

Sobrepõe-se à propriedade BorderWidth . Definir esta propriedade não é suportado pelo ListView controlo.

ChildControlsCreated

Recebe um valor que indica se os controlos filhos do controlo do servidor foram criados.

(Herdado de Control)
ClientID

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

(Herdado de Control)
ClientIDMode

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

(Herdado de Control)
ClientIDRowSuffix

Obtém ou define o nome do campo de dados cujo valor é usado para identificar de forma única cada linha de dados de um ListView controlo quando a ClientIDMode propriedade é definida para Predictable.

ClientIDRowSuffixDataKeys

Obtém os valores de dados que são usados para identificar de forma única cada instância de um controlo data-bound quando ASP.NET gera o valor ClientID.

ClientIDSeparator

Obtém um valor de carácter que representa o carácter separador usado na ClientID propriedade.

(Herdado de Control)
Context

Obtém o controlo do HttpContext objeto associado ao servidor para o pedido Web atual.

(Herdado de Control)
Controls

Obtém um ControlCollection objeto que representa os controlos filhos do ListView controlo.

ControlStyle

Recebe o estilo do controlo do servidor Web. Esta propriedade é utilizada principalmente por promotores de controlo.

(Herdado de WebControl)
ControlStyleCreated

Recebe um valor que indica se um Style objeto foi criado para a ControlStyle propriedade. Esta propriedade é utilizada principalmente por promotores de controlo.

(Herdado de WebControl)
ConvertEmptyStringToNull

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

CssClass

Sobrepõe-se à propriedade CssClass . Definir esta propriedade não é suportado pelo ListView controlo.

DataItemContainer

Obtém uma referência ao contentor de nomes se o contentor implementar IDataItemContainer.

(Herdado de Control)
DataKeyNames

Obtém ou define um array que contém os nomes dos campos de chave primária para os itens apresentados num ListView controlo.

DataKeys

Obtém uma coleção de DataKey objetos que representam o valor da chave de dados para cada item num ListView controlo.

DataKeysContainer

Obtém uma referência ao contentor de nomes se o contentor implementar IDataKeysControl.

(Herdado de Control)
DataMember

Obtém ou define o nome da lista de dados à qual o controlo de dados se liga, nos casos em que a fonte de dados contém mais do que uma lista distinta de itens de dados.

(Herdado de DataBoundControl)
DataSource

Obtém ou define o objeto a partir do qual o controlo ligado a dados recupera a sua lista de itens de dados.

(Herdado de BaseDataBoundControl)
DataSourceID

Obtém ou define o ID do controlo do qual o controlo limitado por dados recupera a sua lista de itens de dados.

(Herdado de DataBoundControl)
DataSourceObject

Recebe um objeto que implementa a IDataSource interface, que dá acesso ao conteúdo de dados do objeto.

(Herdado de DataBoundControl)
DeleteMethod

Obtém ou define o nome do método a chamar para apagar dados.

DesignMode

Obtém um valor que indica se um controlo está a ser usado numa superfície de projeto.

(Herdado de Control)
EditIndex

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

EditItem

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

EditItemTemplate

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

EmptyDataTemplate

Obtém ou define o conteúdo definido pelo utilizador para o template vazio que é renderizado quando um ListView controlo está associado a uma fonte de dados que não contém registos.

EmptyItemTemplate

Recebe ou define o conteúdo definido pelo utilizador para o item vazio que é renderizado num ListView controlo quando não há mais itens de dados para mostrar na última linha da página de dados atual.

Enabled

Recebe ou define um valor que indica se o controlo do servidor Web está ativado.

(Herdado de WebControl)
EnableModelValidation

Recebe ou define um valor que indica se um controlo do validador irá tratar exceções que ocorrem durante operações de inserção ou atualização.

EnablePersistedSelection

Obtém ou define um valor que indica se a seleção de linhas persiste quando um utilizador percorre dados num controlo vinculado a dados.

EnableTheming

Recebe ou define um valor que indica se os temas se aplicam a este controlo.

(Herdado de WebControl)
EnableViewState

Recebe ou define um valor que indica se o controlo do servidor mantém o seu estado de visualização, e o estado de vista de quaisquer controlos filhos que contém, para o cliente solicitante.

(Herdado de Control)
Events

Obtém uma lista de delegados handler de eventos para o controlo. Esta propriedade é somente leitura.

(Herdado de Control)
Font

Sobrepõe-se à propriedade Font . Esta propriedade não é suportada pelo ListView controlo.

ForeColor

Sobrepõe-se à propriedade ForeColor . Definir esta propriedade não é suportado pelo ListView controlo.

GroupItemCount

Obtém ou define o número de itens a exibir por grupo num ListView controlo.

GroupPlaceholderID

Obtém ou define o ID do grupo temporário num ListView controlo.

GroupSeparatorTemplate

Obtém ou define o conteúdo definido pelo utilizador para o separador entre grupos num ListView controlo.

GroupTemplate

Obtém ou define o conteúdo definido pelo utilizador para o contentor do grupo num ListView controlo.

HasAttributes

Recebe um valor que indica se o controlo tem atributos definidos.

(Herdado de WebControl)
HasChildViewState

Recebe um valor que indica se os controlos filhos do controlo atual do servidor têm alguma configuração de estado de visualização guardada.

(Herdado de Control)
Height

Sobrepõe-se à propriedade Height . Definir esta propriedade não é suportado pelo ListView controlo.

ID

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

(Herdado de Control)
IdSeparator

Faz com que o carácter seja usado para separar identificadores de controlo.

(Herdado de Control)
Initialized

Obtém um valor que indica se o controlo ligado a dados foi inicializado.

(Herdado de BaseDataBoundControl)
InsertItem

Obtém o item inserido de um ListView controlo.

InsertItemPosition

Obtém ou define a localização do InsertItemTemplate template quando este é renderizado como parte do ListView controlo.

InsertItemTemplate

Obtém ou define o conteúdo personalizado para um item inserido no ListView controlo.

InsertMethod

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

IsBoundUsingDataSourceID

Recebe um valor que indica se a DataSourceID propriedade está definida.

(Herdado de BaseDataBoundControl)
IsChildControlStateCleared

Obtém um valor que indica se os controlos contidos neste controlo têm estado de controlo.

(Herdado de Control)
IsDataBindingAutomatic

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

(Herdado de BaseDataBoundControl)
IsEnabled

Recebe um valor que indica se o controlo está ativado.

(Herdado de WebControl)
IsTrackingViewState

Recebe um valor que indica se o controlo do servidor está a guardar alterações ao estado de visualização.

(Herdado de Control)
IsUsingModelBinders

Obtém um valor que indica se a binding do modelo está em uso.

IsViewStateEnabled

Recebe um valor que indica se o estado de visualização está ativado para este controlo.

(Herdado de Control)
ItemPlaceholderID

Obtém ou define o ID do item marcador num ListView controlo.

Items

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

ItemSeparatorTemplate

Obtém ou define o conteúdo personalizado para o separador entre os itens num ListView controlo.

ItemTemplate

Obtém ou define o conteúdo personalizado do elemento de dados num ListView controlo.

ItemType

Obtém ou define o nome do tipo de elemento de dados para ligação de dados fortemente tipada.

(Herdado de DataBoundControl)
LayoutTemplate

Obtém ou define o conteúdo personalizado para o contentor raiz num ListView controlo.

LoadViewStateByID

Recebe um valor que indica se o controlo participa no carregamento do seu estado de visualização em ID vez de index.

(Herdado de Control)
MaximumRows

Obtém o número máximo de itens para mostrar numa única página do ListView controlo.

NamingContainer

Obtém uma referência ao contentor de nomes do controlo do servidor, que cria um namespace único para diferenciar controlos de servidor com o mesmo ID valor de propriedade.

(Herdado de Control)
Page

Obtém uma referência à Page instância que contém o controlo do servidor.

(Herdado de Control)
Parent

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

(Herdado de Control)
RenderingCompatibility

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

(Herdado de Control)
RequiresDataBinding

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

(Herdado de BaseDataBoundControl)
SelectArguments

Obtém um DataSourceSelectArguments objeto que o controlo data-bound usa ao recuperar dados de um controlo de fonte de dados.

(Herdado de DataBoundControl)
SelectedDataKey

Obtém o valor da chave de dados para o item selecionado num ListView controlo.

SelectedIndex

Obtém ou define o índice do item selecionado num ListView controlo.

SelectedItemTemplate

Obtém ou define o conteúdo personalizado para o item selecionado num ListView controlo.

SelectedPersistedDataKey

Obtém ou define o valor da chave de dados para o item selecionado persistido num controlo data-bound.

SelectedValue

Obtém o valor da chave de dados do item selecionado num ListView controlo.

SelectMethod

O nome do método a chamar para ler dados.

(Herdado de DataBoundControl)
Site

Obtém informação sobre o contentor que aloja o controlo atual quando renderizado numa superfície de design.

(Herdado de Control)
SkinID

Obtém ou fixa a pele para aplicar no controlo.

(Herdado de WebControl)
SortDirection

Obtém a direção do campo ou campos que estão a ser organizados.

SortExpression

Obtém a expressão de ordenação associada ao campo ou campos que estão a ser ordenados.

StartRowIndex

Obtém o índice do primeiro registo que é exibido numa página de dados no ListView controlo.

Style

Recebe uma coleção de atributos de texto que serão renderizados como um atributo de estilo na etiqueta externa do controlo do servidor Web.

(Herdado de WebControl)
SupportsDisabledAttribute

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

(Herdado de BaseDataBoundControl)
TabIndex

Sobrepõe-se à propriedade TabIndex . Definir esta propriedade não é suportado pelo ListView controlo.

TagKey

Obtém o HtmlTextWriterTag valor correspondente a este controlo do servidor Web. Esta propriedade é utilizada principalmente por promotores de controlo.

(Herdado de WebControl)
TagName

Recebe o nome da etiqueta de controlo. Esta propriedade é utilizada principalmente por promotores de controlo.

(Herdado de WebControl)
TemplateControl

Recebe ou define uma referência ao template que contém esse controlo.

(Herdado de Control)
TemplateSourceDirectory

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

(Herdado de Control)
ToolTip

Sobrepõe-se à propriedade ToolTip . Definir esta propriedade não é suportado pelo ListView controlo.

UniqueID

Obtém o identificador único e hierarquicamente qualificado para o controlo do servidor.

(Herdado de Control)
UpdateMethod

Obtém ou define o nome do método a chamar para atualizar os dados.

ValidateRequestMode

Recebe ou define um valor que indica se o controlo verifica a entrada do cliente do navegador para valores potencialmente perigosos.

(Herdado de Control)
ViewState

Obtém um dicionário de informação de estado que permite guardar e restaurar o estado de visualização de um controlo de servidor através de múltiplos pedidos para a mesma página.

(Herdado de Control)
ViewStateIgnoresCase

Obtém um valor que indica se o StateBag objeto é indistinto a maiúsculas e maiúsculas.

(Herdado de Control)
ViewStateMode

Obtém ou define o modo view-state deste controlo.

(Herdado de Control)
Visible

Recebe ou define um valor que indica se um controlo de servidor é renderizado como UI na página.

(Herdado de Control)
Width

Sobrepõe-se à propriedade Width . Definir esta propriedade não é suportado pelo ListView controlo.

Métodos

Name Description
AddAttributesToRender(HtmlTextWriter)

Adiciona atributos e estilos HTML que precisam de ser renderizados para o especificado HtmlTextWriterTag. Este método é utilizado principalmente por reveladores de controlo.

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

Adiciona o controlo especificado ao contentor especificado.

AddedControl(Control, Int32)

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

(Herdado de Control)
AddParsedSubObject(Object)

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

(Herdado de Control)
ApplyStyle(Style)

Copia quaisquer elementos não em branco do estilo especificado para o controlo Web, sobrescrevendo quaisquer elementos de estilo existentes do controlo. Este método é usado principalmente por desenvolvedores de controlo.

(Herdado de WebControl)
ApplyStyleSheetSkin(Page)

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

(Herdado de Control)
BeginRenderTracing(TextWriter, Object)

Inicia o rastreio em tempo de design dos dados de renderização.

(Herdado de Control)
BuildProfileTree(String, Boolean)

Recolhe informações sobre o controlo do servidor e entrega-as à Trace propriedade para serem exibidas quando o rastreamento for ativado para a página.

(Herdado de Control)
ClearCachedClientID()

Define o valor em ClientID cache para null.

(Herdado de Control)
ClearChildControlState()

Apaga a informação de estado de controlo dos controlos filhos do controlo do servidor.

(Herdado de Control)
ClearChildState()

Apaga a informação de view-state e control-state de todos os controlos filhos do servidor.

(Herdado de Control)
ClearChildViewState()

Elimina a informação de estado de visualização de todos os controlos filhos do controlo do servidor.

(Herdado de Control)
ClearEffectiveClientIDMode()

Define a ClientIDMode propriedade da instância de controlo atual e de qualquer controlo filho para Inherit.

(Herdado de Control)
ConfirmInitState()

Define o estado inicializado do controlo ligado a dados.

(Herdado de BaseDataBoundControl)
CopyBaseAttributes(WebControl)

Copia as propriedades não encapsuladas pelo Style objeto do controlo do servidor Web especificado para o controlo do servidor Web de onde este método é chamado. Este método é utilizado principalmente por reveladores de controlo.

(Herdado de WebControl)
CreateChildControls()

Cria a hierarquia de controlo que é usada para renderizar o ListView controlo, com base nos valores armazenados no estado da vista.

CreateChildControls(IEnumerable, Boolean)

Cria a hierarquia de controlo que é usada para renderizar o ListView controlo usando a fonte de dados especificada.

CreateControlCollection()

Cria um novo ControlCollection objeto para armazenar os controlos filhos (tanto literais como de servidor) do controlo do servidor.

(Herdado de Control)
CreateControlStyle()

Cria o estilo padrão do controlo.

CreateDataItem(Int32, Int32)

Cria um elemento de dados no ListView controlo.

CreateDataSourceSelectArguments()

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

CreateEmptyDataItem()

Cria o EmptyDataTemplate modelo no ListView controlo.

CreateEmptyItem()

Cria um item vazio no ListView controlo.

CreateInsertItem()

Cria um item inserido no ListView controlo.

CreateItem(ListViewItemType)

Cria um ListViewItem objeto com o tipo especificado.

CreateItemsInGroups(ListViewPagedDataSource, Boolean, InsertItemPosition, ArrayList)

Cria a ListView hierarquia de controlo em grupos.

CreateItemsWithoutGroups(ListViewPagedDataSource, Boolean, InsertItemPosition, ArrayList)

Cria a ListView hierarquia de controlo sem grupos.

CreateLayoutTemplate()

Cria o contentor raiz no ListView controlo.

CreateSuffixArrayList(ListViewPagedDataSource, ArrayList)

Cria um array de sufixos para ASP.NET usar quando gera o valor ClientID.

DataBind()

Vincula uma fonte de dados ao controlo do servidor invocado e a todos os seus controlos filhos.

(Herdado de BaseDataBoundControl)
DataBind(Boolean)

Vincula uma fonte de dados ao controlo do servidor invocado e a todos os seus controlos filhos com uma opção para elevar o DataBinding evento.

(Herdado de Control)
DataBindChildren()

Vincula uma fonte de dados aos controlos filhos do controlo do servidor.

(Herdado de Control)
DeleteItem(Int32)

Apaga o registo no índice especificado da fonte de dados.

Dispose()

Permite que o controlo do servidor realize a limpeza final antes de ser libertado da memória.

(Herdado de Control)
EndRenderTracing(TextWriter, Object)

Termina o rastreio de tempo de design dos dados de renderização.

(Herdado de Control)
EnsureChildControls()

Determina se o controlo do servidor contém controlos filhos. Se não o fizer, cria controlos filhos.

(Herdado de Control)
EnsureDataBound()

Chama o DataBind() método se a DataSourceID propriedade estiver definida e o controlo data-bound estiver marcado para exigir ligação.

(Herdado de BaseDataBoundControl)
EnsureID()

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

(Herdado de Control)
EnsureLayoutTemplate()

Assegura que o LayoutTemplate conteúdo é corretamente criado no ListView controlo.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

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

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

FindControl(String, Int32)

Pesquisa no contentor de nomenclatura atual um controlo de servidor com o especificado id e um inteiro, especificados no pathOffset parâmetro, o que auxilia na pesquisa. Não deve sobrepor-se a esta versão do FindControl método.

(Herdado de Control)
FindControl(String)

Procura no contentor de nomenclatura atual um controlo de servidor com o parâmetro especificado id .

(Herdado de Control)
FindPlaceholder(String, Control)

Pesquisa no contentor especificado um controlo que tenha o identificador especificado.

Focus()

Define o foco de entrada num controlo.

(Herdado de Control)
GetData()

Recupera um DataSourceView objeto que o controlo data-bound utiliza para realizar operações de dados.

(Herdado de DataBoundControl)
GetDataSource()

Recupera a IDataSource interface à qual o controlo de dados está associado, se existir.

(Herdado de DataBoundControl)
GetDesignModeState()

Obtém dados de tempo de projeto para um controlo.

(Herdado de Control)
GetHashCode()

Serve como função de hash predefinida.

(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 o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota.

(Herdado de Control)
GetRouteUrl(String, RouteValueDictionary)

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

(Herdado de Control)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
GetUniqueIDRelativeTo(Control)

Devolve a parte prefixada da UniqueID propriedade do controlo especificado.

(Herdado de Control)
HasControls()

Determina se o controlo do servidor contém algum controlo filho.

(Herdado de Control)
HasEvents()

Devolve um valor que indica se os eventos estão registados para o controlo ou para quaisquer controlos filhos.

(Herdado de Control)
InsertNewItem(Boolean)

Insere o registo atual na fonte de dados.

InstantiateEmptyDataTemplate(Control)

Preenche o objeto especificado Control usando os controlos filhos contidos no EmptyDataTemplate template.

InstantiateEmptyItemTemplate(Control)

Preenche o objeto especificado Control usando os controlos filhos contidos no EmptyItemTemplate template.

InstantiateGroupSeparatorTemplate(Control)

Preenche o objeto especificado Control usando os controlos filhos contidos no GroupSeparatorTemplate template.

InstantiateGroupTemplate(Control)

Preenche o objeto especificado Control usando os controlos filhos contidos no GroupTemplate template.

InstantiateInsertItemTemplate(Control)

Preenche o objeto especificado Control usando os controlos filhos contidos no InsertItemTemplate template.

InstantiateItemSeparatorTemplate(Control)

Preenche o objeto especificado Control usando os controlos filhos contidos no ItemSeparatorTemplate template.

InstantiateItemTemplate(Control, Int32)

Preenche o objeto especificado Control usando controlos filhos de um dos ListView modelos de controlo.

IsLiteralContent()

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

(Herdado de Control)
LoadControlState(Object)

Carrega o estado das propriedades no ListView controlo que devem ser mantidas, mesmo quando a EnableViewState propriedade está definida para false.

LoadViewState(Object)

Carrega o estado de visualização previamente guardado do ListView controlo.

MapPathSecure(String)

Recupera o caminho físico para o qual um caminho virtual, seja absoluto ou relativo, mapeia.

(Herdado de Control)
MarkAsDataBound()

Define o estado do controlo no estado de visualização como vinculado com sucesso aos dados.

(Herdado de DataBoundControl)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
MergeStyle(Style)

Copia quaisquer elementos não em branco do estilo especificado para o controlo Web, mas não sobrescreve quaisquer elementos de estilo existentes do controlo. Este método é utilizado principalmente por reveladores de controlo.

(Herdado de WebControl)
OnBubbleEvent(Object, EventArgs)

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

OnCreatingModelDataSource(CreatingModelDataSourceEventArgs)

Eleva o CreatingModelDataSource evento.

(Herdado de DataBoundControl)
OnDataBinding(EventArgs)

Eleva o DataBinding evento.

(Herdado de Control)
OnDataBound(EventArgs)

Eleva o DataBound evento.

(Herdado de BaseDataBoundControl)
OnDataPropertyChanged()

Volta a vincular o controlo ligado aos dados aos seus dados após uma das propriedades de identificação da fonte base de dados alterar.

(Herdado de DataBoundControl)
OnDataSourceViewChanged(Object, EventArgs)

Eleva o DataSourceViewChanged evento.

(Herdado de DataBoundControl)
OnInit(EventArgs)

Eleva o Init evento.

OnItemCanceling(ListViewCancelEventArgs)

Eleva o ItemCanceling evento.

OnItemCommand(ListViewCommandEventArgs)

Eleva o ItemCommand evento.

OnItemCreated(ListViewItemEventArgs)

Eleva o ItemCreated evento.

OnItemDataBound(ListViewItemEventArgs)

Eleva o ItemDataBound evento.

OnItemDeleted(ListViewDeletedEventArgs)

Eleva o ItemDeleted evento.

OnItemDeleting(ListViewDeleteEventArgs)

Eleva o ItemDeleting evento.

OnItemEditing(ListViewEditEventArgs)

Eleva o ItemEditing evento.

OnItemInserted(ListViewInsertedEventArgs)

Eleva o ItemInserted evento.

OnItemInserting(ListViewInsertEventArgs)

Eleva o ItemInserting evento.

OnItemUpdated(ListViewUpdatedEventArgs)

Eleva o ItemUpdated evento.

OnItemUpdating(ListViewUpdateEventArgs)

Eleva o ItemUpdating evento.

OnLayoutCreated(EventArgs)

Eleva o LayoutCreated evento.

OnLoad(EventArgs)

Trata do Load evento.

(Herdado de DataBoundControl)
OnPagePreLoad(Object, EventArgs)

Define o estado inicializado do controlo ligado a dados antes de este ser carregado.

(Herdado de DataBoundControl)
OnPagePropertiesChanged(EventArgs)

Eleva o PagePropertiesChanged evento.

OnPagePropertiesChanging(PagePropertiesChangingEventArgs)

Eleva o PagePropertiesChanging evento.

OnPreRender(EventArgs)

Trata do PreRender evento.

(Herdado de BaseDataBoundControl)
OnSelectedIndexChanged(EventArgs)

Eleva o SelectedIndexChanged evento.

OnSelectedIndexChanging(ListViewSelectEventArgs)

Eleva o SelectedIndexChanging evento.

OnSorted(EventArgs)

Eleva o Sorted evento.

OnSorting(ListViewSortEventArgs)

Eleva o Sorting evento.

OnTotalRowCountAvailable(PageEventArgs)

Eleva o IPageableItemContainer.TotalRowCountAvailable evento.

OnUnload(EventArgs)

Eleva o Unload evento.

(Herdado de Control)
OpenFile(String)

Recebe um Stream usado para ler um ficheiro.

(Herdado de Control)
PerformDataBinding(IEnumerable)

Vincula o ListView controlo à fonte de dados especificada.

PerformSelect()

Recupera dados da fonte de dados associada.

RaiseBubbleEvent(Object, EventArgs)

Atribui quaisquer fontes do evento e da sua informação ao pai do controlo.

(Herdado de Control)
RemovedControl(Control)

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

(Herdado de Control)
RemoveItems()

Elimina todos os controlos filhos num item ou contentor de grupo do ListView controlo.

Render(HtmlTextWriter)

Renderiza o conteúdo de controlo do servidor Web para o navegador do cliente usando o objeto especificado HtmlTextWriter .

RenderBeginTag(HtmlTextWriter)

Renderiza a etiqueta de abertura HTML do controlo ao escritor especificado. Este método é utilizado principalmente por reveladores de controlo.

(Herdado de WebControl)
RenderChildren(HtmlTextWriter)

Exporta o conteúdo dos filhos de um controlo de servidor para um objeto fornecido HtmlTextWriter , que escreve o conteúdo a ser renderizado no cliente.

(Herdado de Control)
RenderContents(HtmlTextWriter)

Apresenta o conteúdo do controlo ao autor especificado. Este método é utilizado principalmente por reveladores de controlo.

(Herdado de WebControl)
RenderControl(HtmlTextWriter, ControlAdapter)

Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter usando um objeto fornecido ControlAdapter .

(Herdado de Control)
RenderControl(HtmlTextWriter)

Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter e armazena informação de rastreamento sobre o controlo se o rastreio estiver ativado.

(Herdado de Control)
RenderEndTag(HtmlTextWriter)

Renderiza a etiqueta HTML de fecho do controlo no escritor especificado. Este método é utilizado principalmente por reveladores de controlo.

(Herdado de WebControl)
ResolveAdapter()

Faz com que o adaptador de controlo seja responsável por renderizar o controlo especificado.

(Herdado de Control)
ResolveClientUrl(String)

Recebe um URL que pode ser usado pelo navegador.

(Herdado de Control)
ResolveUrl(String)

Converte uma URL numa que seja utilizável no cliente solicitante.

(Herdado de Control)
SaveControlState()

Guarda o estado das propriedades no ListView controlo que devem ser mantidas, mesmo quando a EnableViewState propriedade está definida para false.

SaveViewState()

Guarda o estado atual de visualização do ListView controlo.

SelectItem(Int32)

Seleciona o item que está em modo de edição num ListView controlo.

SetDesignModeState(IDictionary)

Define dados em tempo de projeto para um controlo.

(Herdado de Control)
SetEditItem(Int32)

Coloca o item especificado em modo de edição num ListView controlo.

SetPageProperties(Int32, Int32, Boolean)

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

SetRenderMethodDelegate(RenderMethod)

Atribui um delegado handler de eventos para renderizar o controlo do servidor e o seu conteúdo no controlo pai.

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

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

(Herdado de Control)
SetTraceData(Object, Object)

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

(Herdado de Control)
Sort(String, SortDirection)

Ordena o ListView controlo, dependendo da expressão de ordenação e direção especificadas.

ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)
TrackViewState()

Faz com que as alterações de estado de vista do controlo sejam rastreadas para que possam ser armazenadas no objeto do StateBag controlo.

(Herdado de DataBoundControl)
UpdateItem(Int32, Boolean)

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

ValidateDataSource(Object)

Verifica se o objeto ao qual um controlo databound se liga é um com o qual pode trabalhar.

(Herdado de DataBoundControl)

evento

Name Description
CallingDataMethods

Ocorre quando métodos de dados estão a ser chamados.

(Herdado de DataBoundControl)
CreatingModelDataSource

Ocorre quando o ModelDataSource objeto está a ser criado.

(Herdado de DataBoundControl)
DataBinding

Ocorre quando o controlo do servidor se liga a uma fonte de dados.

(Herdado de Control)
DataBound

Ocorre depois de o controlo do servidor se ligar a uma fonte de dados.

(Herdado de BaseDataBoundControl)
Disposed

Ocorre quando um controlo de servidor é libertado da memória, que é a última etapa do ciclo de vida do controlo do servidor quando uma página ASP.NET é solicitada.

(Herdado de Control)
Init

Ocorre quando o controlo do servidor é inicializado, que é o primeiro passo no seu ciclo de vida.

(Herdado de Control)
ItemCanceling

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

ItemCommand

Ocorre quando um botão num ListView controlo é pressionado.

ItemCreated

Ocorre quando um item é criado num ListView controlo.

ItemDataBound

Ocorre quando um elemento de dados está ligado a dados num ListView controlo.

ItemDeleted

Ocorre quando é solicitada uma operação de eliminação, após o controlo ListView eliminar o item.

ItemDeleting

Ocorre quando é solicitada uma operação de eliminação, mas antes de o controlo ListView eliminar o item.

ItemEditing

Ocorre quando uma operação de edição é solicitada, mas antes de o ListView item ser colocado em modo de edição.

ItemInserted

Ocorre quando uma operação de inserção é solicitada, depois de o controlo ListView ter inserido o item na fonte de dados.

ItemInserting

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

ItemUpdated

Ocorre quando uma operação de atualização é solicitada, após o controlo ListView atualizar o item.

ItemUpdating

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

LayoutCreated

Ocorre quando o LayoutTemplate template é criado num ListView controlo.

Load

Ocorre quando o controlo do servidor é carregado no Page objeto.

(Herdado de Control)
PagePropertiesChanged

Ocorre quando as propriedades da página mudam, depois de o controlo ListView definir os novos valores.

PagePropertiesChanging

Ocorre quando as propriedades da página mudam, mas antes do controlo ListView definir os novos valores.

PreRender

Ocorre depois do carregamento do Control objeto, mas antes da renderização.

(Herdado de Control)
SelectedIndexChanged

Ocorre quando o botão Select de um item é clicado, depois de o ListView controlo tratar da operação de seleção.

SelectedIndexChanging

Ocorre quando o botão Select de um item é carregado, mas antes do controlo ListView realizar a operação de seleção.

Sorted

Ocorre quando uma operação de ordenação é solicitada, depois de o ListView controlo tratar da operação de ordenação.

Sorting

Ocorre quando uma operação de ordenação é solicitada, mas antes de o ListView controlo tratar da operação de ordenação.

Unload

Ocorre quando o controlo do servidor é descarregado da memória.

(Herdado de Control)

Implementações de Interface Explícita

Name Description
IAttributeAccessor.GetAttribute(String)

Recebe um atributo do controlo Web com o nome especificado.

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

Define um atributo do controlo Web ao nome e valor especificados.

(Herdado de WebControl)
IControlBuilderAccessor.ControlBuilder

Para uma descrição deste elemento, veja ControlBuilder.

(Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()

Para uma descrição deste elemento, veja GetDesignModeState().

(Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Para uma descrição deste elemento, veja SetDesignModeState(IDictionary).

(Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Para uma descrição deste elemento, veja SetOwnerControl(Control).

(Herdado de Control)
IControlDesignerAccessor.UserData

Para uma descrição deste elemento, veja UserData.

(Herdado de Control)
IDataBindingsAccessor.DataBindings

Para uma descrição deste elemento, veja DataBindings.

(Herdado de Control)
IDataBindingsAccessor.HasDataBindings

Para uma descrição deste elemento, veja HasDataBindings.

(Herdado de Control)
IDataBoundControl.DataKeyNames

Obtém ou define um array que contém os nomes dos campos de chave primária dos itens que são exibidos num controlo ligado a dados.

IDataBoundControl.DataMember

Obtém ou define o nome da lista de dados à qual o controlo limitado por dados se liga quando a fonte de dados contém mais do que uma lista distinta de itens de dados.

IDataBoundControl.DataSource

Obtém ou define o objeto a partir do qual um controlo ligado a dados recupera a sua lista de itens de dados.

IDataBoundControl.DataSourceID

Obtém ou define o ID do controlo de fonte de dados a partir do qual um controlo limitado por dados recupera a sua lista de itens de dados.

IDataBoundControl.DataSourceObject

Recebe um objeto que implementa a IDataSource interface, que dá acesso ao conteúdo de dados do objeto.

IDataBoundListControl.ClientIDRowSuffix

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

IDataBoundListControl.DataKeys

Obtém uma coleção de valores de chave de dados que representam cada linha num controlo de dados limitado.

IDataBoundListControl.EnablePersistedSelection

Obtém ou define o valor que especifica se uma linha selecionada persiste quando um utilizador passa por dados num controlo vinculado a dados.

IDataBoundListControl.SelectedDataKey

Obtém o objeto data-key que contém o valor data-key para a linha selecionada num controlo data-bound.

IDataBoundListControl.SelectedIndex

Obtém ou define o índice da linha selecionada num controlo data-bound.

IDataKeysControl.ClientIDRowSuffixDataKeys

Obtém uma coleção dos valores de dados usados para identificar de forma única cada instância de um controlo data-bound quando ASP.NET gera o valor ClientID.

IExpressionsAccessor.Expressions

Para uma descrição deste elemento, veja Expressions.

(Herdado de Control)
IExpressionsAccessor.HasExpressions

Para uma descrição deste elemento, veja HasExpressions.

(Herdado de Control)
IPageableItemContainer.MaximumRows

Para uma descrição deste elemento, veja MaximumRows.

IPageableItemContainer.SetPageProperties(Int32, Int32, Boolean)

Para uma descrição deste elemento, veja SetPageProperties(Int32, Int32, Boolean).

IPageableItemContainer.StartRowIndex

Para uma descrição deste elemento, veja StartRowIndex.

IPageableItemContainer.TotalRowCountAvailable

Para uma descrição deste elemento, veja TotalRowCountAvailable.

IParserAccessor.AddParsedSubObject(Object)

Para uma descrição deste elemento, veja AddParsedSubObject(Object).

(Herdado de Control)
IPersistedSelector.DataKey

Obtém ou define o valor da chave de dados para o registo selecionado num controlo ligado a dados.

Métodos da Extensão

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

Ativa o comportamento de Dados Dinâmicos para o controlo de dados especificado.

EnableDynamicData(INamingContainer, Type, Object)

Ativa o comportamento de Dados Dinâmicos para o controlo de dados especificado.

EnableDynamicData(INamingContainer, Type)

Ativa o comportamento de Dados Dinâmicos para o controlo de dados especificado.

EnablePersistedSelection(BaseDataBoundControl)
Obsoleto.

Permite que a seleção seja mantida em controlos de dados que suportam a seleção e a paginação.

FindDataSourceControl(Control)

Devolve a fonte de dados associada ao controlo de dados para o controlo especificado.

FindFieldTemplate(Control, String)

Devolve o modelo de campo para a coluna especificada no contentor de nomenclatura do controlo especificado.

FindMetaTable(Control)

Devolve o objeto metatable para o controlo de dados que contém.

GetDefaultValues(INamingContainer)

Obtém a recolha dos valores padrão para o controlo de dados especificado.

GetMetaTable(INamingContainer)

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

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

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

SetMetaTable(INamingContainer, MetaTable, Object)

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

SetMetaTable(INamingContainer, MetaTable)

Define os metadados da tabela para o controlo de dados especificado.

TryGetMetaTable(INamingContainer, MetaTable)

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

Aplica-se a

Ver também