Partager via


ListView Classe

Définition

Affiche les valeurs d’une source de données à l’aide de modèles définis par l’utilisateur. Le contrôle ListView permet aux utilisateurs de sélectionner, trier, supprimer, modifier et insérer des enregistrements.

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
Héritage
Attributs
Implémente

Exemples

L’exemple suivant montre comment utiliser le ListView contrôle pour afficher les enregistrements d’une base de données à l’aide d’une table HTML. Les valeurs sont récupérées à l’aide d’un LinqDataSource contrôle .

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

L’exemple suivant montre comment utiliser le contrôle pour afficher des ListView valeurs dans une disposition de flux à l’aide de l’élément div . Les valeurs sont récupérées à l’aide d’un SqlDataSource contrôle .

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

L’exemple suivant montre comment utiliser le ListView contrôle pour insérer, supprimer et mettre à jour des enregistrements.

Important

Cet exemple comprend une zone de texte qui accepte une entrée d'utilisateur, ce qui constitue une menace potentielle pour la sécurité. Par défaut, les pages web ASP.NET vérifient que l’entrée d’utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des attaques 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>

Remarques

Dans cette rubrique :

Introduction

Le ListView contrôle est utilisé pour afficher les valeurs d’une source de données. Il ressemble au GridView contrôle, sauf qu’il affiche des données à l’aide de modèles définis par l’utilisateur au lieu de champs de ligne. La création de vos propres modèles vous offre plus de flexibilité dans le contrôle de la façon dont les données sont affichées.

Un projet Visual Studio avec du code source est disponible pour accompagner cette rubrique : Télécharger.

Le ListView contrôle prend en charge les fonctionnalités suivantes :

  • Prise en charge de la liaison à des contrôles de source de données tels que SqlDataSource, LinqDataSourceet ObjectDataSource.

  • Apparence personnalisable par le biais de modèles et de styles définis par l’utilisateur.

  • Fonctionnalités de tri intégrées.

  • Fonctionnalités de mise à jour et de suppression intégrées.

  • Fonctionnalités d’insertion intégrées.

  • Prise en charge des fonctionnalités de pagination à l’aide d’un DataPager contrôle.

  • Fonctionnalités de sélection d’élément intégrées.

  • Accès par programmation au ListView modèle objet pour définir dynamiquement les propriétés, gérer les événements, etc.

  • Plusieurs champs de clé.

Pour en savoir plus sur les autres contrôles liés aux données disponibles dans ASP.NET, consultez Contrôles serveur web liés aux données.

Modèles

Pour que le contrôle affiche du ListView contenu, vous devez créer des modèles pour différentes parties du contrôle. L'attribut ItemTemplate est requis. Tous les autres modèles sont facultatifs. La LayoutTemplate propriété n’est pas obligatoire.

Toutefois, vous devez créer un modèle pour le mode dans lequel le contrôle est configuré. Par exemple, un modèle doit être défini pour un ListView contrôle qui prend en charge l’insertion d’enregistrements InsertItemTemplate . Le tableau suivant répertorie les modèles que vous pouvez créer pour le ListView contrôle.

Type de modèle Description
LayoutTemplate Modèle racine qui définit un objet conteneur, tel qu’un tableélément , divou span qui contiendra le contenu défini dans le ItemTemplate modèle ou GroupTemplate . Il peut également contenir un DataPager objet .
ItemTemplate Définit le contenu lié aux données à afficher pour des éléments individuels.
ItemSeparatorTemplate Définit le contenu à afficher entre des éléments individuels.
GroupTemplate Définit un objet conteneur, tel qu’une ligne de table (tr), divou span un élément, qui contiendra le contenu défini dans les ItemTemplate modèles et EmptyItemTemplate . Le nombre d’éléments affichés dans un groupe est spécifié par la GroupItemCount propriété .
GroupSeparatorTemplate Définit le contenu à restituer entre les groupes d’éléments.
EmptyItemTemplate Définit le contenu à restituer pour un élément vide lorsqu’un GroupTemplate modèle est utilisé. Par exemple, si la GroupItemCount propriété a la valeur 5 et que le nombre total d’éléments retournés par la source de données est de 8, le dernier groupe de données affiché par le ListView contrôle contiendra trois éléments spécifiés par le ItemTemplate modèle et deux éléments spécifiés par le EmptyItemTemplate modèle.
EmptyDataTemplate Définit le contenu à restituer si la source de données ne retourne aucune donnée.
SelectedItemTemplate Définit le contenu à afficher pour l’élément de données sélectionné afin de différencier l’élément sélectionné des autres éléments.
AlternatingItemTemplate Définit le contenu à restituer pour les éléments en alternance afin de faciliter la distinction entre les éléments consécutifs.
EditItemTemplate Définit le contenu à restituer lorsqu’un élément est en cours de modification. Le EditItemTemplate modèle est rendu à la place du ItemTemplate modèle pour l’élément de données en cours de modification.
InsertItemTemplate Définit le contenu à restituer pour insérer un élément. Le InsertItemTemplate modèle est rendu à la place d’un ItemTemplate modèle au début ou à la fin des éléments affichés par le ListView contrôle. Vous pouvez spécifier l’emplacement où le InsertItemTemplate modèle est rendu à l’aide de la InsertItemPosition propriété du ListView contrôle.

Pour afficher la valeur d’un champ dans un modèle tel que ItemTemplate, vous utilisez une expression de liaison de données. Pour plus d’informations sur les expressions de liaison de données, consultez Vue d’ensemble des expressions de liaison de données.

Pour lier des contrôles d’entrée dans les EditItemTemplate modèles et InsertItemTemplate aux champs d’une source de données, vous pouvez utiliser des expressions de liaison bidirectionnelle. Cela permet au ListView contrôle d’extraire automatiquement les valeurs du contrôle d’entrée pour une opération de mise à jour ou d’insertion. Les expressions de liaison bidirectionnelle activent également les contrôles d’entrée dans un pour afficher automatiquement les valeurs de champ d’origine EditItemTemplate . Pour plus d’informations sur les expressions de liaison bidirectionnelle, consultez Liaison à des bases de données.

Liaison à une source de données

Vous pouvez lier le ListView contrôle à un contrôle de source de données (tel que le contrôle ou ObjectDataSource le SqlDataSource contrôle) ou à toute collection de source de données qui implémente l’interfaceSystem.Collections.IEnumerable, comme System.Data.DataView, System.Collections.ArrayList, System.Collections.Generic.List<T>ou d’autres types de collection. Utilisez l’une des méthodes suivantes pour lier le ListView contrôle au type de source de données approprié :

  • Pour établir une liaison à un contrôle de source de données, définissez la DataSourceID propriété du ListView contrôle sur la ID valeur du contrôle de source de données. Le ListView contrôle se lie automatiquement au contrôle de source de données spécifié et peut tirer parti des fonctionnalités du contrôle de source de données pour effectuer le tri, l’insertion, la mise à jour, la suppression et la pagination. Il s’agit de la méthode recommandée pour lier des données.

  • Pour établir une liaison à une source de données qui implémente l’interface System.Collections.IEnumerable , définissez par programmation la DataSource propriété du ListView contrôle sur la source de données, puis appelez la DataBind méthode. Lorsque vous utilisez cette technique, le ListView contrôle ne fournit pas de fonctionnalités intégrées de tri, de mise à jour, de suppression et de pagination. Vous devez fournir cette fonctionnalité à l’aide de l’événement approprié.

Pour plus d’informations sur la liaison de données, consultez ASP.NET Data Access Content Map.

Notes

Le ListView contrôle peut être utilisé pour afficher l’entrée utilisateur, qui peut inclure un script client malveillant. Vérifiez les informations envoyées à partir d’un client pour le script exécutable, les instructions SQL ou tout autre code avant de les afficher dans l’application. Nous recommandons vivement que les valeurs soient encodées au format HTML chaque fois que cela est possible avant d’être affichées dans ce contrôle. ASP.NET fournit une fonctionnalité de validation des demandes d’entrée pour aider à bloquer le script et le code HTML dans l’entrée utilisateur. Vous pouvez également utiliser des contrôles serveur de validation pour vérifier les entrées utilisateur. Pour plus d’informations, consultez Présentation des contrôles de validation.

Opérations de données

Lorsque le ListView contrôle est lié à un contrôle de source de données, celui-ci ListView peut tirer parti des fonctionnalités du contrôle de source de données et fournir des fonctionnalités de tri, d’insertion, de mise à jour et de suppression automatiques.

Notes

Le ListView contrôle peut prendre en charge le tri, l’insertion, la mise à jour et la suppression avec d’autres types de sources de données. Toutefois, pour implémenter ces opérations, vous devez créer du code dans un gestionnaire d’événements approprié.

Étant donné que le ListView contrôle utilise des modèles, il ne permet pas de générer automatiquement des boutons pour effectuer des opérations de mise à jour, de suppression, d’insertion, de tri ou de sélection. Vous devez inclure manuellement ces boutons dans le modèle approprié. Le ListView contrôle reconnaît certains boutons dont CommandName la propriété est définie sur une valeur spécifique. Le tableau suivant répertorie les boutons que le ListView contrôle reconnaît et leurs fonctions.

Bouton Valeur CommandName Description
Annuler « Annuler » Annule une opération de modification ou d’insertion. Déclenche l’événement ItemCanceling.
Supprimer "Delete" Supprime l'enregistrement actuel de la source de données. Déclenche les ItemDeleted événements et ItemDeleting .
Sélectionnez « Sélectionner » Définit la SelectedIndex propriété sur la valeur de la DisplayIndex propriété pour l’élément. Affiche le SelectedItemTemplate modèle de l’élément. Déclenche les SelectedIndexChanging événements et SelectedIndexChanged .
Modifier « Modifier » Place l’élément en mode édition. Affiche le EditItemTemplate modèle de l’élément. Déclenche l’événement ItemEditing.
Insérer « Insérer » Insère les valeurs liées du InsertItemTemplate modèle dans la source de données. Déclenche les ItemInserting événements et ItemInserted .
Update « Mise à jour » Met à jour l’enregistrement actif dans la source de données avec les valeurs liées du EditItemTemplate modèle. Déclenche les ItemUpdating événements et ItemUpdated .
Trier « Trier » Trie les colonnes répertoriées dans la CommandArgument propriété du bouton. Déclenche les Sorting événements et Sorted .

Contrairement au bouton Supprimer (qui supprime immédiatement l’élément de données actif), lorsque vous cliquez sur le bouton Modifier, le ListView contrôle affiche l’élément actif en mode édition. En mode édition, le contenu contenu dans la EditItemTemplate propriété s’affiche pour l’élément de données actif. En règle générale, dans le modèle modifier l’élément, le bouton Modifier est remplacé par un bouton Mettre à jour et annuler. Les contrôles d’entrée appropriés pour le type de données du champ (par exemple, un TextBox contrôle ou CheckBox ) affichent généralement la valeur d’un champ qu’un utilisateur doit modifier. Cliquer sur le bouton Mettre à jour met à jour l’enregistrement dans la source de données, et cliquer sur le bouton Annuler annule l’opération de modification.

La fonctionnalité d’insertion est activée lorsque la propriété a la InsertItemPosition valeur FirstItem ou LastItem. Cette propriété définit l’emplacement où le InsertItemTemplate modèle est rendu pour l’élément d’insertion. Le modèle d’insertion d’élément comprend généralement un bouton Insérer et un bouton Annuler, et des contrôles d’entrée vides s’affichent pour permettre aux utilisateurs d’entrer les valeurs du nouvel enregistrement. Cliquer sur le bouton Insérer insère l’enregistrement dans la source de données, et cliquer sur le bouton Annuler efface tous les champs.

Tri

Le ListView contrôle permet aux utilisateurs de trier les éléments en cliquant sur le bouton Trier. La fonctionnalité de tri est définie dans la CommandArgument propriété du bouton qui contient les colonnes à trier.

Pagination

Au lieu d’afficher tous les enregistrements de la source de données en même temps, le ListView contrôle peut diviser les enregistrements en pages. Pour activer la pagination, associez un DataPager contrôle au ListView contrôle. Insérez ensuite un DataPager contrôle à l’intérieur du LayoutTemplate modèle. Si le contrôle est en dehors du DataPagerListView contrôle, définissez la PagedControlID propriété sur le ID du ListView contrôle.

Événements

Le tableau suivant répertorie les événements pris en charge par le ListView contrôle.

Événement Description
ItemCanceling Se produit lorsque le bouton Annuler (un bouton dont la CommandName propriété est définie sur « Annuler ») est cliqué, mais avant que le ListView contrôle annule l’opération d’insertion ou de modification. Cet événement est souvent utilisé pour arrêter l’opération d’annulation.
ItemCommand Se produit lors d'un clic sur le bouton d'un contrôle ListView. Cet événement est souvent utilisé pour effectuer une tâche personnalisée lorsqu’un bouton est cliqué dans le contrôle.
ItemCreated Se produit lorsqu’un nouvel élément est créé dans le ListView contrôle. Cet événement est souvent utilisé pour modifier le contenu d’un élément lors de sa création.
ItemDataBound Se produit lorsqu’un élément de données est lié aux données du ListView contrôle. Cet événement est souvent utilisé pour modifier le contenu d’un élément lorsque l’élément est lié à des données.
ItemDeleted Se produit lorsqu’un bouton Supprimer (un bouton dont la CommandName propriété est définie sur « Supprimer ») est cliqué ou que la DeleteItem méthode est appelée, après que le ListView contrôle a supprimé l’enregistrement de la source de données. Cet événement est souvent utilisé pour vérifier les résultats de l’opération de suppression.
ItemDeleting Se produit lorsqu’un bouton Supprimer (bouton dont la CommandName propriété est définie sur « Supprimer ») est cliqué ou que la DeleteItem méthode est appelée, mais avant que le ListView contrôle supprime l’enregistrement de la source de données. Cet événement est souvent utilisé pour confirmer ou annuler l’opération de suppression.
ItemEditing Se produit lorsqu’un bouton Modifier (un bouton dont la CommandName propriété est définie sur « Modifier ») est cliqué, mais avant que le ListView contrôle ne passe en mode édition. Cet événement est souvent utilisé pour annuler l’opération de modification.
ItemInserted Se produit lorsqu’un bouton Insérer (un bouton dont la CommandName propriété est définie sur « Insérer ») est cliqué ou que la InsertNewItem méthode est appelée, après que le ListView contrôle insère le nouvel enregistrement à partir de la source de données. Cet événement est souvent utilisé pour vérifier les résultats de l’opération d’insertion.
ItemInserting Se produit lorsqu’un bouton Insérer (un bouton dont la CommandName propriété est définie sur « Insérer ») est cliqué ou que la InsertNewItem méthode est appelée, mais avant que le ListView contrôle insère l’enregistrement. Cet événement est souvent utilisé pour annuler l’opération d’insertion ou modifier ou valider les valeurs du nouvel élément.
ItemUpdated Se produit lorsqu’un bouton Mettre à jour (un bouton dont la CommandName propriété est définie sur « Mettre à jour ») est cliqué ou que la UpdateItem méthode est appelée, après que le ListView contrôle a mis à jour l’enregistrement. Cet événement est souvent utilisé pour vérifier les résultats de l’opération de mise à jour.
ItemUpdating Se produit lorsqu’un bouton Mettre à jour (un bouton dont la CommandName propriété est définie sur « Mettre à jour ») est cliqué ou que la UpdateItem méthode est appelée, mais avant que le ListView contrôle ne met à jour l’enregistrement. Cet événement est souvent utilisé pour annuler l’opération de mise à jour ou modifier ou valider les valeurs de l’élément modifié.
LayoutCreated Se produit lorsque le modèle LayoutTemplate est créé dans un contrôle ListView. Cet événement est souvent utilisé pour effectuer une tâche après la création du modèle.
PagePropertiesChanged Se produit lorsque les propriétés de page sont modifiées, après que le contrôle ListView ait défini les nouvelles valeurs.
PagePropertiesChanging Se produit lorsque les propriétés de la page de données changent, mais avant que le ListView contrôle ne définisse les nouvelles valeurs.
SelectedIndexChanged Se produit lorsqu’un bouton Sélectionner (un bouton dont la CommandName propriété est définie sur « Sélectionner ») est cliqué, une fois que le ListView contrôle a géré l’opération de sélection. Cet événement est souvent utilisé pour effectuer une tâche personnalisée après la sélection d’un élément dans le contrôle.
SelectedIndexChanging Se produit lorsqu’un bouton Sélectionner (un bouton dont la CommandName propriété est définie sur « Sélectionner ») est cliqué, mais avant que le ListView contrôle ne gère l’opération de sélection. Cet événement est souvent utilisé pour annuler l’opération de sélection.
Sorted Se produit lorsqu’un bouton Trier (un bouton dont la CommandName propriété est définie sur « Trier ») est cliqué ou que la Sort méthode est appelée, une fois que le ListView contrôle a géré l’opération de tri. Cet événement est généralement utilisé pour effectuer une tâche personnalisée après qu’un utilisateur clique sur un bouton Trier et que les données ont été triées.
Sorting Se produit lorsqu’un bouton Trier (un bouton dont la CommandName propriété est définie sur « Trier ») est cliqué ou que la Sort méthode est appelée, mais avant que le ListView contrôle ne gère l’opération de tri. Cet événement est souvent utilisé pour annuler l’opération de tri ou pour effectuer une routine de tri personnalisée.

Syntaxe déclarative

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

Constructeurs

ListView()

Initialise une nouvelle instance de la classe ListView.

Propriétés

AccessKey

Substitue la propriété AccessKey. La définition de cette propriété n'est pas prise en charge par le contrôle ListView.

Adapter

Obtient l'adaptateur spécifique au navigateur pour le contrôle.

(Hérité de Control)
AlternatingItemTemplate

Obtient ou définit le contenu personnalisé pour l'élément de données en alternance dans un contrôle ListView.

AppRelativeTemplateSourceDirectory

Obtient ou définit le répertoire virtuel relatif à l'application de l'objet Page ou UserControl qui contient ce contrôle.

(Hérité de Control)
Attributes

Obtient la collection d'attributs arbitraires (pour le rendu uniquement) qui ne correspondent pas à des propriétés du contrôle.

(Hérité de WebControl)
BackColor

Substitue la propriété BackColor. La définition de cette propriété n'est pas prise en charge par le contrôle ListView.

BindingContainer

Obtient le contrôle qui contient la liaison de données de ce contrôle.

(Hérité de Control)
BorderColor

Substitue la propriété BorderColor. La définition de cette propriété n'est pas prise en charge par le contrôle ListView.

BorderStyle

Substitue la propriété BorderStyle. La définition de cette propriété n'est pas prise en charge par le contrôle ListView.

BorderWidth

Substitue la propriété BorderWidth. La définition de cette propriété n'est pas prise en charge par le contrôle ListView.

ChildControlsCreated

Obtient une valeur qui indique si des contrôles enfants du contrôle serveur ont été créés.

(Hérité de Control)
ClientID

Obtient l’ID de contrôle du balisage HTML généré par ASP.NET.

(Hérité de Control)
ClientIDMode

Obtient ou définit l'algorithme utilisé pour générer la valeur de la propriété ClientID.

(Hérité de Control)
ClientIDRowSuffix

Obtient ou définit le nom du champ de données dont la valeur est utilisée pour identifier de façon unique chaque ligne de données d'un contrôle ListView lorsque la propriété ClientIDMode a la valeur Predictable.

ClientIDRowSuffixDataKeys

Obtient les valeurs de données utilisées pour identifier de façon unique chaque instance d'un contrôle lié aux données lorsqu'ASP.NET génère la valeur ClientID.

ClientIDSeparator

Obtient une valeur de caractère représentant le caractère de séparation utilisé dans la propriété ClientID.

(Hérité de Control)
Context

Obtient l'objet HttpContext associé au contrôle serveur pour la demande Web en cours.

(Hérité de Control)
Controls

Obtient un objet ControlCollection qui représente les contrôles enfant du contrôle ListView.

ControlStyle

Obtient le style d'un contrôle serveur Web. Cette propriété est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
ControlStyleCreated

Obtient une valeur indiquant si un objet Style a été créé pour la propriété ControlStyle. Cette propriété est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
ConvertEmptyStringToNull

Obtient ou définit une valeur qui indique si les chaînes vides ("") sont converties automatiquement en valeurs null quand le champ de données est mis à jour dans la source de données.

CssClass

Substitue la propriété CssClass. La définition de cette propriété n'est pas prise en charge par le contrôle ListView.

DataItemContainer

Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataItemContainer.

(Hérité de Control)
DataKeyNames

Obtient ou définit un tableau qui contient les noms des champs clés primaires pour les éléments affichés dans un contrôle ListView.

DataKeys

Obtient une collection d'objets DataKey qui représentent la valeur de clé de données pour chaque élément dans un contrôle ListView.

DataKeysContainer

Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataKeysControl.

(Hérité de Control)
DataMember

Obtient ou définit le nom de la liste des données auxquelles le contrôle lié aux données se lie, dans les cas où la source de données contient plusieurs listes distinctes d'éléments de données.

(Hérité de DataBoundControl)
DataSource

Obtient ou définit l'objet duquel le contrôle lié aux données récupère sa liste d'éléments de données.

(Hérité de BaseDataBoundControl)
DataSourceID

Obtient ou définit l’ID du contrôle à partir duquel le contrôle lié aux données récupère sa liste d’éléments de données.

(Hérité de DataBoundControl)
DataSourceObject

Obtient un objet qui implémente l'interface IDataSource, qui fournit l'accès au contenu des données de l'objet.

(Hérité de DataBoundControl)
DeleteMethod

Obtient ou définit le nom de la méthode à appeler afin de supprimer des données.

DesignMode

Obtient une valeur indiquant si un contrôle est utilisé sur une aire de conception.

(Hérité de Control)
EditIndex

Obtient ou définit l'index de l'élément en cours de modification.

EditItem

Obtient l'élément qui est en mode modification dans un contrôle ListView.

EditItemTemplate

Obtient ou définit le contenu personnalisé de l'élément en mode Édition.

EmptyDataTemplate

Obtient ou définit le contenu défini par l'utilisateur pour le modèle vide rendu lorsqu'un contrôle ListView est lié à une source de données qui ne contient pas d'enregistrements.

EmptyItemTemplate

Obtient ou définit le contenu défini par l'utilisateur pour l'élément vide restitué dans un contrôle ListView lorsqu'il n'y a plus d'éléments de données à afficher dans la dernière ligne de la page de données actuelle.

Enabled

Obtient ou définit une valeur indiquant si le contrôle serveur Web est activé.

(Hérité de WebControl)
EnableModelValidation

Obtient ou définit une valeur qui indique si un contrôle de validateur doit gérer les exceptions susceptibles de se produire lors des opérations d'insertion ou de mise à jour.

EnablePersistedSelection

Obtient ou définit une valeur qui indique si la sélection de ligne persiste lorsqu'un utilisateur parcourt des données dans un contrôle lié aux données.

EnableTheming

Obtient ou définit une valeur indiquant si les thèmes s'appliquent à ce contrôle.

(Hérité de WebControl)
EnableViewState

Obtient ou définit une valeur indiquant si le contrôle serveur conserve son état d’affichage, et l’état d’affichage de tous les contrôles enfants qu’il contient, au client demandeur.

(Hérité de Control)
Events

Obtient la liste des délégués de gestionnaires d'événements pour le contrôle. Cette propriété est en lecture seule.

(Hérité de Control)
Font

Substitue la propriété Font. Cette propriété n'est pas prise en charge par le contrôle ListView.

ForeColor

Substitue la propriété ForeColor. La définition de cette propriété n'est pas prise en charge par le contrôle ListView.

GroupItemCount

Obtient ou définit le nombre d'éléments à afficher par groupe dans un contrôle ListView.

GroupPlaceholderID

Obtient ou définit l'ID pour l'espace réservé de groupe dans un contrôle ListView.

GroupSeparatorTemplate

Obtient ou définit le contenu défini par l'utilisateur pour le séparateur de groupes dans un contrôle ListView.

GroupTemplate

Obtient ou définit le contenu défini par l'utilisateur pour le conteneur de groupe dans un contrôle ListView.

HasAttributes

Obtient une valeur indiquant si le contrôle a des attributs définis.

(Hérité de WebControl)
HasChildViewState

Obtient une valeur indiquant si les contrôles enfants du contrôle serveur en cours possèdent des paramètres d'état d'affichage enregistrés.

(Hérité de Control)
Height

Substitue la propriété Height. La définition de cette propriété n'est pas prise en charge par le contrôle ListView.

ID

Obtient ou définit l'ID programmatique assigné au contrôle serveur.

(Hérité de Control)
IdSeparator

Obtient le caractère utilisé pour séparer des identificateurs de contrôle.

(Hérité de Control)
Initialized

Obtient une valeur indiquant si le contrôle lié aux données a été initialisé.

(Hérité de BaseDataBoundControl)
InsertItem

Obtient l'élément d'insertion dans un contrôle ListView.

InsertItemPosition

Obtient ou définit l'emplacement du modèle InsertItemTemplate lorsqu'il est restitué dans le cadre du contrôle ListView.

InsertItemTemplate

Obtient ou définit le contenu personnalisé pour un élément d'insertion dans le contrôle ListView.

InsertMethod

Obtient ou définit le nom de la méthode à appeler afin d'insérer des données.

IsBoundUsingDataSourceID

Obtient une valeur indiquant si la propriété DataSourceID est définie.

(Hérité de BaseDataBoundControl)
IsChildControlStateCleared

Obtient une valeur indiquant si les contrôles contenus dans ce contrôle utilisent l'état du contrôle.

(Hérité de Control)
IsDataBindingAutomatic

Obtient une valeur qui indique si la liaison de données est automatique.

(Hérité de BaseDataBoundControl)
IsEnabled

Obtient une valeur indiquant si le contrôle est activé.

(Hérité de WebControl)
IsTrackingViewState

Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d'affichage.

(Hérité de Control)
IsUsingModelBinders

Obtient une valeur qui indique si la liaison de modèle est utilisée.

IsUsingModelBinders

Obtient une valeur qui indique si la liaison de modèle est utilisée.

(Hérité de DataBoundControl)
IsViewStateEnabled

Obtient une valeur indiquant si l'état d'affichage est activé pour ce contrôle.

(Hérité de Control)
ItemPlaceholderID

Obtient ou définit l'ID pour l'espace réservé d'élément dans un contrôle ListView.

Items

Obtient une collection d'objets ListViewDataItem qui représentent les éléments de données de la page de données actuelle dans un contrôle ListView.

ItemSeparatorTemplate

Obtient ou définit le contenu personnalisé pour le séparateur entre les éléments dans un contrôle ListView.

ItemTemplate

Obtient ou définit le contenu personnalisé pour l'élément de données dans un contrôle ListView.

ItemType

Obtient ou définit le nom du type d'élément de données pour la liaison de données fortement typée.

(Hérité de DataBoundControl)
LayoutTemplate

Obtient ou définit le contenu personnalisé pour le conteneur racine dans un contrôle ListView.

LoadViewStateByID

Obtient une valeur indiquant si le contrôle participe au chargement de son état d'affichage par ID et non par index.

(Hérité de Control)
MaximumRows

Obtient le nombre d'éléments maximum à afficher sur une même page du contrôle ListView.

NamingContainer

Obtient une référence au conteneur d'attribution de noms du contrôle serveur, qui crée un espace de noms unique pour différencier les contrôles serveur dont la propriété ID possède la même valeur.

(Hérité de Control)
Page

Obtient une référence à l'instance de Page qui contient le contrôle serveur.

(Hérité de Control)
Parent

Obtient une référence au contrôle parent du contrôle serveur dans la hiérarchie des contrôles de la page.

(Hérité de Control)
RenderingCompatibility

Obtient une valeur qui spécifie la version ASP.NET avec laquelle le HTML restitué sera compatible.

(Hérité de Control)
RequiresDataBinding

Obtient ou définit une valeur indiquant si la méthode DataBind() doit être appelée.

(Hérité de BaseDataBoundControl)
SelectArguments

Obtient un objet DataSourceSelectArguments que le contrôle lié aux données utilise lors de la récupération de données d'un contrôle de source de données.

(Hérité de DataBoundControl)
SelectedDataKey

Obtient la valeur de clés des données pour l'élément sélectionné dans un contrôle ListView.

SelectedIndex

Obtient ou définit l'index de l'élément sélectionné dans un contrôle ListView.

SelectedItemTemplate

Obtient ou définit le contenu personnalisé pour l'élément sélectionné dans un contrôle ListView.

SelectedPersistedDataKey

Obtient ou définit la valeur de clé de données de l'élément persistant sélectionné dans un contrôle lié aux données.

SelectedValue

Obtient la valeur de clés des données de l'élément sélectionné dans un contrôle ListView.

SelectMethod

Nom de la méthode à appeler pour pouvoir lire les données.

(Hérité de DataBoundControl)
Site

Obtient des informations sur le conteneur qui héberge le contrôle en cours lorsqu'il est rendu sur une aire de conception.

(Hérité de Control)
SkinID

Obtient ou définit l’apparence à appliquer au contrôle.

(Hérité de WebControl)
SortDirection

Obtient le sens de tri du champ ou des champs en cours de tri.

SortExpression

Obtient l'expression de tri associée au champ ou aux champs en cours de tri.

StartRowIndex

Obtient l'index du premier enregistrement affiché dans une page de données dans le contrôle ListView.

Style

Obtient une collection d'attributs de texte qui sont rendus en tant qu'attribut de style sur la balise extérieure d'un contrôle serveur Web.

(Hérité de WebControl)
SupportsDisabledAttribute

Obtient une valeur qui indique si le contrôle doit définir l'attribut disabled de l'élément HTML rendu avec la valeur « disabled » quand la propriété IsEnabled du contrôle a la valeur false.

(Hérité de BaseDataBoundControl)
TabIndex

Substitue la propriété TabIndex. La définition de cette propriété n'est pas prise en charge par le contrôle ListView.

TagKey

Obtient la valeur HtmlTextWriterTag qui correspond à ce contrôle serveur Web. Cette propriété est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
TagName

Obtient le nom de la balise du contrôle. Cette propriété est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
TemplateControl

Obtient ou définit une référence au modèle qui contient ce contrôle.

(Hérité de Control)
TemplateSourceDirectory

Obtient le répertoire virtuel du Page ou du UserControl qui contient le contrôle serveur en cours.

(Hérité de Control)
ToolTip

Substitue la propriété ToolTip. La définition de cette propriété n'est pas prise en charge par le contrôle ListView.

UniqueID

Obtient l'identificateur unique qualifié sur le plan hiérarchique du contrôle serveur.

(Hérité de Control)
UpdateMethod

Obtient ou définit le nom de la méthode à appeler afin de mettre à jour des données.

ValidateRequestMode

Obtient ou définit une valeur qui indique si le contrôle vérifie l'entrée cliente du navigateur à la recherche de valeurs potentiellement dangereuses.

(Hérité de Control)
ViewState

Obtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et de restaurer l'état d'affichage d'un contrôle serveur entre plusieurs demandes de la même page.

(Hérité de Control)
ViewStateIgnoresCase

Obtient une valeur qui indique si l'objet StateBag respecte la casse.

(Hérité de Control)
ViewStateMode

Obtient ou définit le mode d'état d'affichage de ce contrôle.

(Hérité de Control)
Visible

Obtient ou définit une valeur qui indique si un contrôle serveur est rendu en tant qu’interface utilisateur sur la page.

(Hérité de Control)
Width

Substitue la propriété Width. La définition de cette propriété n'est pas prise en charge par le contrôle ListView.

Méthodes

AddAttributesToRender(HtmlTextWriter)

Ajoute des attributs et des styles HTML qui doivent être rendus au HtmlTextWriterTag spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
AddControlToContainer(Control, Control, Int32)

Ajoute le contrôle spécifié au conteneur spécifié.

AddedControl(Control, Int32)

Méthode appelée après qu’un contrôle enfant est ajouté à la collection Controls de l’objet Control.

(Hérité de Control)
AddParsedSubObject(Object)

Avertit le contrôle serveur qu’un élément XML ou HTML a été analysé, et ajoute l’élément à l’objet ControlCollection du contrôle serveur.

(Hérité de Control)
ApplyStyle(Style)

Copie tous les éléments non vides du style spécifié vers le contrôle Web, en remplaçant les éléments de style existants du contrôle. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
ApplyStyleSheetSkin(Page)

Applique les propriétés de style définies dans la feuille de style de la page au contrôle.

(Hérité de Control)
BeginRenderTracing(TextWriter, Object)

Commence le traçage au moment du design des données de rendu.

(Hérité de Control)
BuildProfileTree(String, Boolean)

Collecte des informations sur le contrôle serveur et les livre à la propriété Trace à afficher lorsque le traçage est activé pour la page.

(Hérité de Control)
ClearCachedClientID()

Affecte à la valeur ClientID mise en cache la valeur null.

(Hérité de Control)
ClearChildControlState()

Supprime les informations sur l'état du contrôle des contrôles enfants du contrôle serveur.

(Hérité de Control)
ClearChildState()

Supprime les informations sur l'état d'affichage et sur l'état du contrôle de tous les contrôles enfants du contrôle serveur.

(Hérité de Control)
ClearChildViewState()

Supprime les informations d'état d'affichage de tous les contrôles enfants du contrôle serveur.

(Hérité de Control)
ClearEffectiveClientIDMode()

Affecte la valeur ClientIDMode à la propriété Inherit de l'instance de contrôle actuelle et de tous contrôles enfants.

(Hérité de Control)
ConfirmInitState()

Définit l'état initialisé du contrôle lié aux données.

(Hérité de BaseDataBoundControl)
CopyBaseAttributes(WebControl)

Copie les propriétés non encapsulées par l'objet Style du contrôle serveur Web spécifié vers le contrôle serveur Web à partir duquel cette méthode est appelée. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
CreateChildControls()

Crée la hiérarchie des contrôles utilisée pour restituer le contrôle ListView, basé sur les valeurs qui sont stockées dans l'état d'affichage.

CreateChildControls(IEnumerable, Boolean)

Crée la hiérarchie des contrôles qui est utilisée pour restituer le contrôle ListView à l'aide de la source de données spécifiée.

CreateControlCollection()

Crée un objet ControlCollection pour contenir les contrôles enfants (littéraux et serveur) du contrôle serveur.

(Hérité de Control)
CreateControlStyle()

Crée le style par défaut du contrôle.

CreateDataItem(Int32, Int32)

Crée un élément de données dans le contrôle ListView.

CreateDataSourceSelectArguments()

Crée l'objet DataSourceSelectArguments qui contient les arguments passés à la source de données.

CreateEmptyDataItem()

Crée le modèle EmptyDataTemplate dans le contrôle ListView.

CreateEmptyItem()

Crée un élément vide dans le contrôle ListView.

CreateInsertItem()

Crée un élément d'insertion dans le contrôle ListView.

CreateItem(ListViewItemType)

Crée un objet ListViewItem avec le type spécifié.

CreateItemsInGroups(ListViewPagedDataSource, Boolean, InsertItemPosition, ArrayList)

Crée la hiérarchie des contrôles ListView dans des groupes.

CreateItemsWithoutGroups(ListViewPagedDataSource, Boolean, InsertItemPosition, ArrayList)

Crée la hiérarchie des contrôles ListView sans groupes.

CreateLayoutTemplate()

Crée le conteneur racine dans le contrôle ListView.

CreateSuffixArrayList(ListViewPagedDataSource, ArrayList)

Crée un tableau de suffixes pour qu'ASP.NET l'utilise lorsqu'il génère la valeur ClientID.

DataBind()

Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants.

(Hérité de BaseDataBoundControl)
DataBind(Boolean)

Lie une source de données au contrôle serveur appelé et tous ses contrôles enfants avec une option pour déclencher l'événement DataBinding.

(Hérité de Control)
DataBindChildren()

Lie une source de données aux contrôles enfants du contrôle serveur.

(Hérité de Control)
DeleteItem(Int32)

Supprime l'enregistrement à l'index spécifié de la source de données.

Dispose()

Permet à un contrôle serveur d'effectuer le nettoyage final avant qu'il soit libéré de la mémoire.

(Hérité de Control)
EndRenderTracing(TextWriter, Object)

Met fin au traçage au moment du design des données de rendu.

(Hérité de Control)
EnsureChildControls()

Détermine si le contrôle serveur contient des contrôles enfants. S'il ne contient pas de contrôles enfants, il en crée.

(Hérité de Control)
EnsureDataBound()

Appelle la méthode DataBind() si la propriété DataSourceID est définie et que le contrôle lié aux données est marqué pour demander à être lié.

(Hérité de BaseDataBoundControl)
EnsureID()

Crée un identificateur pour les contrôles auxquels aucun identificateur n'est assigné.

(Hérité de Control)
EnsureLayoutTemplate()

Garantit que le contenu LayoutTemplate est créé correctement dans le contrôle ListView.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
ExtractItemValues(IOrderedDictionary, ListViewItem, Boolean)

Récupère les valeurs de chaque champ déclarées dans l'élément spécifié et les stocke dans l'objet IOrderedDictionary spécifié.

FindControl(String)

Recherche un contrôle serveur possédant le paramètre id spécifié dans le conteneur d'attribution de noms actuel.

(Hérité de Control)
FindControl(String, Int32)

Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec l'id spécifié et un entier, spécifié dans le paramètre pathOffset, qui facilite la recherche. Vous ne devez pas substituer cette version de la méthode FindControl.

(Hérité de Control)
FindPlaceholder(String, Control)

Recherche le conteneur spécifié pour un contrôle qui possède l'identificateur spécifié.

Focus()

Affecte le focus d'entrée à un contrôle.

(Hérité de Control)
GetData()

Récupère un objet DataSourceView que le contrôle lié aux données utilise pour exécuter des opérations de données.

(Hérité de DataBoundControl)
GetDataSource()

Récupère l'interface IDataSource à laquelle le contrôle lié aux données est associé, le cas échéant.

(Hérité de DataBoundControl)
GetDesignModeState()

Obtient les données au moment du design pour un contrôle.

(Hérité de Control)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetRouteUrl(Object)

Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire.

(Hérité de Control)
GetRouteUrl(RouteValueDictionary)

Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire.

(Hérité de Control)
GetRouteUrl(String, Object)

Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire.

(Hérité de Control)
GetRouteUrl(String, RouteValueDictionary)

Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire.

(Hérité de Control)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
GetUniqueIDRelativeTo(Control)

Retourne la partie préfixée de la propriété UniqueID du contrôle spécifié.

(Hérité de Control)
HasControls()

Détermine si le contrôle serveur contient des contrôles enfants.

(Hérité de Control)
HasEvents()

Retourne une valeur indiquant si des événements sont inscrits pour le contrôle ou des contrôles enfants.

(Hérité de Control)
InsertNewItem(Boolean)

Insère l'enregistrement actif dans la source de données.

InstantiateEmptyDataTemplate(Control)

Remplit l'objet Control spécifié en utilisant les contrôles enfants contenus dans le modèle EmptyDataTemplate.

InstantiateEmptyItemTemplate(Control)

Remplit l'objet Control spécifié en utilisant les contrôles enfants contenus dans le modèle EmptyItemTemplate.

InstantiateGroupSeparatorTemplate(Control)

Remplit l'objet Control spécifié en utilisant les contrôles enfants contenus dans le modèle GroupSeparatorTemplate.

InstantiateGroupTemplate(Control)

Remplit l'objet Control spécifié en utilisant les contrôles enfants contenus dans le modèle GroupTemplate.

InstantiateInsertItemTemplate(Control)

Remplit l'objet Control spécifié en utilisant les contrôles enfants contenus dans le modèle InsertItemTemplate.

InstantiateItemSeparatorTemplate(Control)

Remplit l'objet Control spécifié en utilisant les contrôles enfants contenus dans le modèle ItemSeparatorTemplate.

InstantiateItemTemplate(Control, Int32)

Remplit l'objet Control spécifié en utilisant des contrôles enfants de l'un des modèles de contrôle ListView.

IsLiteralContent()

Détermine si le contrôle serveur ne détient qu'un contenu littéral.

(Hérité de Control)
LoadControlState(Object)

Charge l'état des propriétés dans le contrôle ListView à faire persister, même lorsque la propriété EnableViewState a la valeur false.

LoadViewState(Object)

Charge l'état d'affichage enregistré précédemment du contrôle ListView.

MapPathSecure(String)

Récupère le chemin d'accès physique auquel un chemin d'accès virtuel, absolu ou relatif, correspond.

(Hérité de Control)
MarkAsDataBound()

Définit l'état du contrôle dans l'état d'affichage comme lié avec succès aux données.

(Hérité de DataBoundControl)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
MergeStyle(Style)

Copie tous les éléments non vides du style spécifié vers le contrôle Web, mais ne remplace aucun élément de style existant du contrôle. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
OnBubbleEvent(Object, EventArgs)

Détermine si un événement pour le contrôle ListView doit être géré.

OnCreatingModelDataSource(CreatingModelDataSourceEventArgs)

Déclenche l’événement CreatingModelDataSource.

(Hérité de DataBoundControl)
OnDataBinding(EventArgs)

Déclenche l’événement DataBinding.

(Hérité de Control)
OnDataBound(EventArgs)

Déclenche l’événement DataBound.

(Hérité de BaseDataBoundControl)
OnDataPropertyChanged()

Relie le contrôle lié aux données à ses données après la modification d'une des propriétés de l'identification de la source de données de base.

(Hérité de DataBoundControl)
OnDataSourceViewChanged(Object, EventArgs)

Déclenche l’événement DataSourceViewChanged.

(Hérité de DataBoundControl)
OnInit(EventArgs)

Déclenche l’événement Init.

OnItemCanceling(ListViewCancelEventArgs)

Déclenche l’événement ItemCanceling.

OnItemCommand(ListViewCommandEventArgs)

Déclenche l’événement ItemCommand.

OnItemCreated(ListViewItemEventArgs)

Déclenche l’événement ItemCreated.

OnItemDataBound(ListViewItemEventArgs)

Déclenche l’événement ItemDataBound.

OnItemDeleted(ListViewDeletedEventArgs)

Déclenche l’événement ItemDeleted.

OnItemDeleting(ListViewDeleteEventArgs)

Déclenche l’événement ItemDeleting.

OnItemEditing(ListViewEditEventArgs)

Déclenche l’événement ItemEditing.

OnItemInserted(ListViewInsertedEventArgs)

Déclenche l’événement ItemInserted.

OnItemInserting(ListViewInsertEventArgs)

Déclenche l’événement ItemInserting.

OnItemUpdated(ListViewUpdatedEventArgs)

Déclenche l’événement ItemUpdated.

OnItemUpdating(ListViewUpdateEventArgs)

Déclenche l’événement ItemUpdating.

OnLayoutCreated(EventArgs)

Déclenche l’événement LayoutCreated.

OnLoad(EventArgs)

Gère l'événement Load.

(Hérité de DataBoundControl)
OnPagePreLoad(Object, EventArgs)

Définit l'état initialisé du contrôle lié aux données avant que le contrôle ne soit chargé.

(Hérité de DataBoundControl)
OnPagePropertiesChanged(EventArgs)

Déclenche l’événement PagePropertiesChanged.

OnPagePropertiesChanging(PagePropertiesChangingEventArgs)

Déclenche l’événement PagePropertiesChanging.

OnPreRender(EventArgs)

Gère l'événement PreRender.

(Hérité de BaseDataBoundControl)
OnSelectedIndexChanged(EventArgs)

Déclenche l’événement SelectedIndexChanged.

OnSelectedIndexChanging(ListViewSelectEventArgs)

Déclenche l’événement SelectedIndexChanging.

OnSorted(EventArgs)

Déclenche l’événement Sorted.

OnSorting(ListViewSortEventArgs)

Déclenche l’événement Sorting.

OnTotalRowCountAvailable(PageEventArgs)

Déclenche l’événement IPageableItemContainer.TotalRowCountAvailable.

OnUnload(EventArgs)

Déclenche l’événement Unload.

(Hérité de Control)
OpenFile(String)

Obtient un Stream utilisé pour lire un fichier.

(Hérité de Control)
PerformDataBinding(IEnumerable)

Lie la source de données spécifiée au contrôle ListView.

PerformSelect()

Récupère les données de la source de données associée.

RaiseBubbleEvent(Object, EventArgs)

Assigne les sources éventuelles de l'événement et ses informations au parent du contrôle.

(Hérité de Control)
RemovedControl(Control)

Méthode appelée après la suppression d’un contrôle enfant de la collection Controls de l’objet Control.

(Hérité de Control)
RemoveItems()

Supprime tous les contrôles enfants dans un élément ou un conteneur de groupe du contrôle ListView.

Render(HtmlTextWriter)

Génère le rendu du contenu du contrôle serveur Web via le navigateur du client à l'aide de l'objet HtmlTextWriter spécifié.

RenderBeginTag(HtmlTextWriter)

Génère le rendu de la balise d'ouverture HTML du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
RenderChildren(HtmlTextWriter)

Produit le contenu des enfants d'un contrôle serveur dans un objet HtmlTextWriter fourni qui écrit le contenu à restituer sur le client.

(Hérité de Control)
RenderContents(HtmlTextWriter)

Génère le rendu du contenu du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
RenderControl(HtmlTextWriter)

Envoie le contenu du contrôle serveur à un objet HtmlTextWriter fourni et stocke les informations de traçage sur le contrôle si le traçage est activé.

(Hérité de Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Génère le contenu du contrôle serveur dans un objet HtmlTextWriter à l'aide d'un objet ControlAdapter fourni.

(Hérité de Control)
RenderEndTag(HtmlTextWriter)

Génère le rendu de la balise de fermeture HTML du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
ResolveAdapter()

Obtient l'adaptateur de contrôles responsable du rendu du contrôle spécifié.

(Hérité de Control)
ResolveClientUrl(String)

Obtient une URL qui peut être utilisée par le navigateur.

(Hérité de Control)
ResolveUrl(String)

Convertit une URL en une URL que le client soit en mesure d'utiliser.

(Hérité de Control)
SaveControlState()

Enregistre l'état des propriétés dans le contrôle ListView à faire persister, même lorsque la propriété EnableViewState a la valeur false.

SaveViewState()

Enregistre l'état d'affichage actuel du contrôle ListView.

SelectItem(Int32)

Sélectionne l'élément en mode édition dans un contrôle ListView.

SetDesignModeState(IDictionary)

Définit les données au moment du design pour un contrôle.

(Hérité de Control)
SetEditItem(Int32)

Définit l'élément spécifié en mode édition dans un contrôle ListView.

SetPageProperties(Int32, Int32, Boolean)

Définit les propriétés d'une page de données dans le contrôle ListView.

SetRenderMethodDelegate(RenderMethod)

Assigne un délégué de gestionnaires d'événements pour générer le rendu du contrôle serveur et de son contenu dans son contrôle parent.

(Hérité de Control)
SetTraceData(Object, Object)

Définit les données de trace pour le suivi du rendu des données au moment du design à l'aide de la clé des données de trace et de la valeur des données de trace.

(Hérité de Control)
SetTraceData(Object, Object, Object)

Définit les données de trace pour le suivi du rendu des données au moment du design, à l'aide de l'objet suivi, de la clé des données de trace et de la valeur des données de trace.

(Hérité de Control)
Sort(String, SortDirection)

Trie le contrôle ListView selon l'expression et le sens de tri spécifiés.

ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)
TrackViewState()

Provoque le suivi des modifications de l'état d'affichage pour le contrôle afin qu'elles puissent être stockées dans l'objet StateBag du contrôle.

(Hérité de DataBoundControl)
UpdateItem(Int32, Boolean)

Met à jour l'enregistrement à l'index spécifié dans la source de données.

ValidateDataSource(Object)

Vérifie que l'objet auquel un contrôle lié aux données se lie est un objet avec qui il peut fonctionner.

(Hérité de DataBoundControl)

Événements

CallingDataMethods

Se produit lorsque les méthodes de données sont appelées.

(Hérité de DataBoundControl)
CreatingModelDataSource

Se produit lorsque l'objet ModelDataSource est créé.

(Hérité de DataBoundControl)
DataBinding

Se produit lorsque le contrôle serveur se lie à une source de données.

(Hérité de Control)
DataBound

Se produit après la liaison du contrôle serveur à une source de données.

(Hérité de BaseDataBoundControl)
Disposed

Se produit lorsqu'un contrôle serveur est libéré de la mémoire, ce qui constitue la dernière étape du cycle de vie d'un contrôle serveur en cas de demande d'une page ASP.NET.

(Hérité de Control)
Init

Se produit lorsque le contrôle serveur est initialisé, ce qui constitue la première étape de son cycle de vie.

(Hérité de Control)
ItemCanceling

Se produit lorsqu'une opération d'annulation est demandée, mais avant que le contrôle ListView n'annule l'opération d'insertion ou de modification.

ItemCommand

Se produit lorsque l'on clique sur un bouton dans un contrôle ListView.

ItemCreated

Se produit lors de la création d'un élément dans un contrôle ListView.

ItemDataBound

Se produit lorsqu'un élément de données est lié à des données dans un contrôle ListView.

ItemDeleted

Se produit lorsqu'une opération de Suppression est demandée, après que le contrôle ListView ait supprimé l'élément.

ItemDeleting

Se produit lorsqu'une opération de Suppression est demandée, mais avant que le contrôle ListView ait supprimé l'élément.

ItemEditing

Se produit lorsqu'une modification est demandée, mais avant que l'élément ListView soit mis en mode Édition.

ItemInserted

Se produit lorsqu'une opération d'insertion est demandée, après que le contrôle ListView a inséré l'élément dans la source de données.

ItemInserting

Se produit lorsqu'une opération d'insertion est demandée, mais avant que le contrôle ListView n'exécute l'insertion.

ItemUpdated

Se produit lorsqu'une opération de mise à jour est demandée, après que le contrôle ListView ait mis à jour l'élément.

ItemUpdating

Se produit lorsqu'une opération de mise à jour est demandée, mais avant que le contrôle ListView n'ait mis à jour l'élément.

LayoutCreated

Se produit lorsque le modèle LayoutTemplate est créé dans un contrôle ListView.

Load

Se produit lorsque le contrôle serveur est chargé dans l'objet Page.

(Hérité de Control)
PagePropertiesChanged

Se produit lorsque les propriétés de page sont modifiées, après que le contrôle ListView ait défini les nouvelles valeurs.

PagePropertiesChanging

Se produit lorsque les propriétés de pages sont modifiées, mais avant que le contrôle ListView n'ai défini les nouvelles valeurs.

PreRender

Se produit après le chargement de l'objet Control mais avant le rendu.

(Hérité de Control)
SelectedIndexChanged

Se produit en cas de clic sur le bouton de sélection d'un élément, après que le contrôle ListView a géré l'opération de sélection.

SelectedIndexChanging

Se produit en cas de clic sur le bouton de sélection d'un élément, mais avant que le contrôle ListView ne gère l'opération de sélection.

Sorted

Se produit lorsqu'une opération de tri est demandée, après que le contrôle ListView ait géré l'opération de tri.

Sorting

Se produit lorsqu'une opération de tri est demandée, mais avant que le contrôle ListView ne gère l'opération de tri.

Unload

Se produit lorsque le contrôle serveur est déchargé de la mémoire.

(Hérité de Control)

Implémentations d’interfaces explicites

IAttributeAccessor.GetAttribute(String)

Obtient un attribut du contrôle Web avec le nom spécifié.

(Hérité de WebControl)
IAttributeAccessor.SetAttribute(String, String)

Affecte au nom et à la valeur spécifiés un attribut du contrôle Web.

(Hérité de WebControl)
IControlBuilderAccessor.ControlBuilder

Pour obtenir une description de ce membre, consultez ControlBuilder.

(Hérité de Control)
IControlDesignerAccessor.GetDesignModeState()

Pour obtenir une description de ce membre, consultez GetDesignModeState().

(Hérité de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Pour obtenir une description de ce membre, consultez SetDesignModeState(IDictionary).

(Hérité de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Pour obtenir une description de ce membre, consultez SetOwnerControl(Control).

(Hérité de Control)
IControlDesignerAccessor.UserData

Pour obtenir une description de ce membre, consultez UserData.

(Hérité de Control)
IDataBindingsAccessor.DataBindings

Pour obtenir une description de ce membre, consultez DataBindings.

(Hérité de Control)
IDataBindingsAccessor.HasDataBindings

Pour obtenir une description de ce membre, consultez HasDataBindings.

(Hérité de Control)
IDataBoundControl.DataKeyNames

Obtient ou définit un tableau qui contient les noms des champs clé primaire des éléments qui sont affichés dans un contrôle lié aux données.

IDataBoundControl.DataMember

Obtient ou définit le nom de la liste de données à laquelle le contrôle lié aux données se lie lorsque la source de données contient plusieurs listes distinctes d'éléments de données.

IDataBoundControl.DataSource

Obtient ou définit l'objet duquel un contrôle lié aux données récupère sa liste d'éléments de données.

IDataBoundControl.DataSourceID

Obtient ou définit l'ID du contrôle de source de données duquel un contrôle lié aux données récupère sa liste d'éléments de données.

IDataBoundControl.DataSourceObject

Obtient un objet qui implémente l'interface IDataSource, qui fournit l'accès au contenu des données de l'objet.

IDataBoundListControl.ClientIDRowSuffix

Obtient le nom du champ de données dont la valeur est utilisée pour identifier de façon unique chaque ligne de données d'un contrôle ListView lorsque la propriété ClientIDMode a la valeur Predictable.

IDataBoundListControl.DataKeys

Obtient une collection de valeurs de clés de données qui représentent chaque ligne d'un contrôle lié aux données.

IDataBoundListControl.EnablePersistedSelection

Obtient ou définit la valeur qui spécifie si une ligne sélectionnée persiste lorsqu'un utilisateur parcourt des données dans un contrôle lié aux données.

IDataBoundListControl.SelectedDataKey

Obtient l'objet de clé de données qui contient la valeur de clé de données de la ligne sélectionnée dans un contrôle lié aux données.

IDataBoundListControl.SelectedIndex

Obtient ou définit l'index de la ligne sélectionnée dans un contrôle lié aux données.

IDataKeysControl.ClientIDRowSuffixDataKeys

Obtient une collection de valeurs de données utilisées pour identifier de façon unique chaque instance d'un contrôle lié aux données lorsqu'ASP.NET génère la valeur ClientID.

IExpressionsAccessor.Expressions

Pour obtenir une description de ce membre, consultez Expressions.

(Hérité de Control)
IExpressionsAccessor.HasExpressions

Pour obtenir une description de ce membre, consultez HasExpressions.

(Hérité de Control)
IPageableItemContainer.MaximumRows

Pour obtenir une description de ce membre, consultez MaximumRows.

IPageableItemContainer.SetPageProperties(Int32, Int32, Boolean)

Pour obtenir une description de ce membre, consultez SetPageProperties(Int32, Int32, Boolean).

IPageableItemContainer.StartRowIndex

Pour obtenir une description de ce membre, consultez StartRowIndex.

IPageableItemContainer.TotalRowCountAvailable

Pour obtenir une description de ce membre, consultez TotalRowCountAvailable.

IParserAccessor.AddParsedSubObject(Object)

Pour obtenir une description de ce membre, consultez AddParsedSubObject(Object).

(Hérité de Control)
IPersistedSelector.DataKey

Obtient ou définit la valeur de clé de données de l'enregistrement sélectionné dans un contrôle lié aux données.

Méthodes d’extension

EnablePersistedSelection(BaseDataBoundControl)
Obsolète.

Permet la conservation de la sélection dans les contrôles de données qui prennent en charge la sélection et la pagination.

FindDataSourceControl(Control)

Retourne la source de données associée au contrôle de données pour le contrôle spécifié.

FindFieldTemplate(Control, String)

Retourne le modèle de champ pour la colonne spécifiée dans le conteneur d'attribution de noms du contrôle spécifié.

FindMetaTable(Control)

Retourne l'objet Metatable pour le contrôle de données conteneur.

GetDefaultValues(INamingContainer)

Obtient la collection des valeurs par défaut pour le contrôle de données spécifié.

GetMetaTable(INamingContainer)

Obtient les métadonnées de table pour le contrôle de données spécifié.

SetMetaTable(INamingContainer, MetaTable)

Définit les métadonnées de table pour le contrôle de données spécifié.

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

Définit les métadonnées de table et le mappage des valeurs par défaut pour le contrôle de données spécifié.

SetMetaTable(INamingContainer, MetaTable, Object)

Définit les métadonnées de table et le mappage des valeurs par défaut pour le contrôle de données spécifié.

TryGetMetaTable(INamingContainer, MetaTable)

Détermine si des métadonnées de table sont disponibles.

EnableDynamicData(INamingContainer, Type)

Active le comportement Dynamic Data pour le contrôle de données spécifié.

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

Active le comportement Dynamic Data pour le contrôle de données spécifié.

EnableDynamicData(INamingContainer, Type, Object)

Active le comportement Dynamic Data pour le contrôle de données spécifié.

S’applique à

Voir aussi