ListView Класс

Определение

Отображает значения источника данных с помощью пользовательских шаблонов.Displays the values of a data source by using user-defined templates. Элемент управления ListView дает возможность пользователям выбирать, сортировать, удалять, редактировать и вставлять записи.The ListView control enables users to select, sort, delete, edit, and insert records.

public ref class ListView : System::Web::UI::WebControls::DataBoundControl, System::Web::UI::IDataKeysControl, System::Web::UI::INamingContainer, System::Web::UI::WebControls::IDataBoundListControl, System::Web::UI::WebControls::IPageableItemContainer, System::Web::UI::WebControls::IPersistedSelector
[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.ListView), "ListView.bmp")]
[System.Web.UI.ControlValueProperty("SelectedValue")]
[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.ListView), "ListView.ico")]
public class ListView : System.Web.UI.WebControls.DataBoundControl, System.Web.UI.IDataKeysControl, System.Web.UI.INamingContainer, System.Web.UI.WebControls.IDataBoundListControl, System.Web.UI.WebControls.IPageableItemContainer, System.Web.UI.WebControls.IPersistedSelector
type ListView = class
    inherit DataBoundControl
    interface INamingContainer
    interface IPageableItemContainer
    interface IPersistedSelector
    interface IDataKeysControl
    interface IDataBoundListControl
    interface IDataBoundControl
Public Class ListView
Inherits DataBoundControl
Implements IDataBoundListControl, IDataKeysControl, INamingContainer, IPageableItemContainer, IPersistedSelector
Наследование
Атрибуты
Реализации

Примеры

В следующем примере показано, как использовать ListView элемент управления для отображения записей из базы данных с помощью таблицы HTML.The following example shows how to use the ListView control to display records from a database by using an HTML table. Значения извлекаются с помощью LinqDataSource элемента управления.The values are retrieved by using a LinqDataSource control.

<%@ Page language="C#" %>
    
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

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

      <!-- This example uses Microsoft SQL Server and connects   -->
      <!-- to the AdventureWorks sample database. Add a LINQ     -->
      <!-- to SQL class to the project to map to a table in      -->
      <!-- the database.                                         -->
      <asp:LinqDataSource ID="VendorsDataSource" runat="server" 
        ContextTypeName="AdventureWorksClassesDataContext" 
        Select="new (VendorID, AccountNumber, Name, PreferredVendorStatus)" 
        TableName="Vendors" Where="ActiveFlag == @ActiveFlag">
        <WhereParameters>
          <asp:Parameter DefaultValue="true" Name="ActiveFlag" Type="Boolean" />
        </WhereParameters>
      </asp:LinqDataSource>
      
    </form>
  </body>
</html>
<%@ Page language="VB" %>
    
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

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

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

В следующем примере показано, как использовать ListView элемент управления для отображения значений в макете потока с div помощью элемента.The following example shows how to use the ListView control to display values in a flow layout by using the div element. Значения извлекаются с помощью SqlDataSource элемента управления.The values are retrieved by using a SqlDataSource control.

<%@ Page language="C#" %>
    
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>ListView Flow Layout Example</title>
    <style type="text/css">
      .plainBox {
          font-family: Verdana, Arial, sans-serif;
          font-size: 11px;
          background: #ffffff;
          border:1px solid #336666;
          }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">

      <h3>ListView Flow Layout Example</h3>
      
      Select the color:
      <asp:DropDownList ID="ColorList" runat="server" 
        AutoPostBack="True" 
        DataSourceID="ColorDataSource" 
        DataTextField="Color" 
        DataValueField="Color">
      </asp:DropDownList><br /><br />
      
      <asp:ListView runat="server" ID="ProductListView"
        DataSourceID="ProductsDataSource"
        DataKeyNames="ProductID">
        <LayoutTemplate>
          <div runat="server" id="lstProducts">
            <div runat="server" id="itemPlaceholder" />
          </div>
          <asp:DataPager runat="server" PageSize="5" >
            <Fields>
              <asp:NextPreviousPagerField 
                ButtonType="Button"
                ShowFirstPageButton="True" 
                ShowLastPageButton="True" />
            </Fields>
          </asp:DataPager>
        </LayoutTemplate>
        <ItemTemplate>
          <asp:Image ID="ProductImage" runat="server"
            ImageUrl='<%# "~/images/thumbnails/" + Eval("ThumbnailPhotoFileName") %>' />	        
          <div class="plainBox" runat="server">
            <asp:HyperLink ID="ProductLink" runat="server" Text='<%# Eval("Name") %>' 
              NavigateUrl='<%# "ProductDetails.aspx?productID=" + Eval("ProductID") %>' />
            <br /><br />
            <b>Price:</b> 
            <asp:Label ID="PriceLabel" runat="server" Text='<%# Eval("ListPrice", "{0:c}")%>' /> <br />
          </div>
          <br />
        </ItemTemplate>
      </asp:ListView>
      
      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->
      <asp:SqlDataSource ID="ProductsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"            	        
        SelectCommand="SELECT P.ProductID, P.Name, P.Color, P.ListPrice, 
          PF.ThumbnailPhotoFileName, P.Size
          FROM Production.Product AS P 
          INNER JOIN Production.ProductProductPhoto AS PPF ON P.ProductID = PPF.ProductID 
          INNER JOIN Production.ProductPhoto AS PF ON PPF.ProductPhotoID = PF.ProductPhotoID
          WHERE P.Color = @Color" >
        <SelectParameters>
          <asp:ControlParameter ControlID="ColorList" Name="Color" 
            PropertyName="SelectedValue" />
        </SelectParameters>
      </asp:SqlDataSource>

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

    </form>
  </body>
</html>
<%@ Page language="VB" %>
    
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>ListView Flow Layout Example</title>
    <style type="text/css">
      .plainBox {
          font-family: Verdana, Arial, sans-serif;
          font-size: 11px;
          background: #ffffff;
          border:1px solid #336666;
          }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">

      <h3>ListView Flow Layout Example</h3>
      
      Select the color:
      <asp:DropDownList ID="ColorList" runat="server" 
        AutoPostBack="True" 
        DataSourceID="ColorDataSource" 
        DataTextField="Color" 
        DataValueField="Color">
      </asp:DropDownList><br /><br />
      
      <asp:ListView runat="server" ID="ProductListView"
        DataSourceID="ProductsDataSource"
        DataKeyNames="ProductID">
        <LayoutTemplate>
          <div runat="server" id="lstProducts">
            <div runat="server" id="itemPlaceholder" />
          </div>
          <asp:DataPager ID="DataPager1" runat="server" PageSize="5" >
            <Fields>
              <asp:NextPreviousPagerField 
                ButtonType="Button"
                ShowFirstPageButton="True" 
                ShowLastPageButton="True" />
            </Fields>
          </asp:DataPager>
        </LayoutTemplate>
        <ItemTemplate>
          <asp:Image ID="ProductImage" runat="server"
            ImageUrl='<%# "~/images/thumbnails/" & Eval("ThumbnailPhotoFileName") %>' />	        
          <div class="plainBox" runat="server">
            <asp:HyperLink ID="ProductLink" runat="server" Text='<%# Eval("Name") %>' 
              NavigateUrl='<%# "ProductDetails.aspx?productID=" & Eval("ProductID") %>' />
            <br /><br />
            <b>Price:</b> 
            <asp:Label ID="PriceLabel" runat="server" Text='<%# Eval("ListPrice", "{0:c}")%>' /> <br />
          </div>
          <br />
        </ItemTemplate>
      </asp:ListView>
      
      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->
      <asp:SqlDataSource ID="ProductsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"            	        
        SelectCommand="SELECT P.ProductID, P.Name, P.Color, P.ListPrice, 
          PF.ThumbnailPhotoFileName, P.Size
          FROM Production.Product AS P 
          INNER JOIN Production.ProductProductPhoto AS PPF ON P.ProductID = PPF.ProductID 
          INNER JOIN Production.ProductPhoto AS PF ON PPF.ProductPhotoID = PF.ProductPhotoID
          WHERE P.Color = @Color" >
        <SelectParameters>
          <asp:ControlParameter ControlID="ColorList" Name="Color" 
            PropertyName="SelectedValue" />
        </SelectParameters>
      </asp:SqlDataSource>

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

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

В следующем примере показано, как использовать ListView элемент управления для вставки, удаления и обновления записей.The following example shows how to use the ListView control to insert, delete, and update records.

Важно!

В этом примере имеется текстовое поле, принимающее вводимые пользователем данные, что является потенциальной угрозой безопасности.This example has a text box that accepts user input, which is a potential security threat. По умолчанию данные, вводимые пользователем на веб-страницах ASP.NET, проверяются на наличие скриптов и HTML-элементов.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Дополнительные сведения см. в разделе Общие сведения об использовании сценариев.For more information, see Script Exploits Overview.

<%@ Page language="C#" %>
    
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>ListView Example</title>
    <style type="text/css">
        .EditItem { background-color:#8FBC8F;}
        .SelectedItem {	background-color:#9ACD32; }
        .InsertItem { background-color:#FFFACD;}
    </style>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>ListView Example</h3>
      
      <h5>Departments</h5>

      <asp:ListView ID="DepartmentsListView" 
        DataSourceID="DepartmentsDataSource" 
        DataKeyNames="DepartmentID"
        ConvertEmptyStringToNull="true"
        InsertItemPosition="LastItem"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" runat="server" id="tblDepartments" width="640px" cellspacing="0">
            <tr runat="server" id="itemPlaceholder" />
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Button ID="SelectButton" runat="server" Text="Select" CommandName="Select" />
              <asp:Button ID="EditButton" runat="server" Text="Edit" CommandName="Edit" />
            </td>
            <td>
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("DepartmentID") %>' />
            </td>
            <td>
              <asp:Label ID="NameLabel" runat="server" Text='<%#Eval("Name") %>' />
            </td>
            <td>
              <asp:Label ID="GroupNameLabel" runat="server" Text='<%#Eval("GroupName") %>' />
            </td>
          </tr>
        </ItemTemplate>
        <SelectedItemTemplate>
          <tr class="SelectedItem" runat="server">
            <td>
              <asp:Button ID="DeleteButton" runat="server" Text="Delete" CommandName="Delete" />
              <asp:Button ID="EditButton" runat="server" Text="Edit" CommandName="Edit" />
            </td>
            <td>
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("DepartmentID") %>' />
            </td>
            <td>
              <asp:Label ID="NameLabel" runat="server" Text='<%#Eval("Name") %>' />
            </td>
            <td>
              <asp:Label ID="GroupNameLabel" runat="server" Text='<%#Eval("GroupName") %>' />
            </td>
          </tr>
        </SelectedItemTemplate>
        <EditItemTemplate>
          <tr class="EditItem">
            <td>
              <asp:Button ID="UpdateButton" runat="server" CommandName="Update" Text="Update" />
              <asp:Button ID="CancelButton" runat="server" CommandName="Cancel" Text="Cancel" />
            </td>
            <td>
              <b>ID</b><br />
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("DepartmentID") %>' />
            </td>
            <td>
              <asp:Label runat="server" ID="NameLabel" AssociatedControlID="NameTextBox" 
                Text="Name" Font-Bold="true"/><br />
              <asp:TextBox ID="NameTextBox" runat="server" Text='<%#Bind("Name") %>' />
            </td>
            <td>
              <asp:Label runat="server" ID="GroupNameLabel" AssociatedControlID="GroupNameTextBox" 
                Text="Group Name" Font-Bold="true" /><br />
              <asp:TextBox ID="GroupNameTextBox" runat="server" 
                Width="200px"
                Text='<%#Bind("GroupName") %>' />
              <br />
            </td>
          </tr>
        </EditItemTemplate>
        <InsertItemTemplate>
          <tr class="InsertItem">
            <td colspan="2">
              <asp:Button ID="InsertButton" runat="server" CommandName="Insert" Text="Insert" />
              <asp:Button ID="CancelButton" runat="server" CommandName="Cancel" Text="Cancel" />
            </td>
            <td>
              <asp:Label runat="server" ID="NameLabel" AssociatedControlID="NameTextBox" 
                Text="Name" Font-Bold="true"/><br />
              <asp:TextBox ID="NameTextBox" runat="server" Text='<%#Bind("Name") %>' /><br />
            </td>
            <td>
              <asp:Label runat="server" ID="GroupNameLabel" AssociatedControlID="GroupNameTextBox" 
                Text="Group Name" Font-Bold="true" /><br />                
              <asp:TextBox ID="GroupNameTextBox" runat="server" Text='<%#Bind("GroupName") %>' />
            </td>
          </tr>
        </InsertItemTemplate>
      </asp:ListView>

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->            
      <asp:SqlDataSource ID="DepartmentsDataSource" runat="server" 
            ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
            SelectCommand="SELECT DepartmentID, Name, GroupName FROM HumanResources.Department"
            UpdateCommand="UPDATE HumanResources.Department 
                SET Name = @Name, GroupName = @GroupName WHERE (DepartmentID = @DepartmentID)"            
            DeleteCommand="DELETE FROM HumanResources.Department 
                WHERE (DepartmentID = @DepartmentID)" 
            InsertCommand="INSERT INTO HumanResources.Department(Name, GroupName) 
                VALUES (@Name, @GroupName)">
      </asp:SqlDataSource>
      
    </form>
  </body>
</html>
<%@ Page language="VB" %>
    
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>ListView Example</title>
    <style type="text/css">
        .EditItem { background-color:#8FBC8F;}
        .SelectedItem {	background-color:#9ACD32; }
        .InsertItem { background-color:#FFFACD;}
    </style>
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>ListView Example</h3>
      
      <h5>Departments</h5>

      <asp:ListView ID="DepartmentsListView" 
        DataSourceID="DepartmentsDataSource" 
        DataKeyNames="DepartmentID"
        ConvertEmptyStringToNull="true"
        InsertItemPosition="LastItem"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" runat="server" id="tblDepartments" width="640px" cellspacing="0">
            <tr runat="server" id="itemPlaceholder" />
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Button ID="SelectButton" runat="server" Text="Select" CommandName="Select" />
              <asp:Button ID="EditButton" runat="server" Text="Edit" CommandName="Edit" />
            </td>
            <td>
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("DepartmentID") %>' />
            </td>
            <td>
              <asp:Label ID="NameLabel" runat="server" Text='<%#Eval("Name") %>' />
            </td>
            <td>
              <asp:Label ID="GroupNameLabel" runat="server" Text='<%#Eval("GroupName") %>' />
            </td>
          </tr>
        </ItemTemplate>
        <SelectedItemTemplate>
          <tr class="SelectedItem" runat="server">
            <td>
              <asp:Button ID="DeleteButton" runat="server" Text="Delete" CommandName="Delete" />
              <asp:Button ID="EditButton" runat="server" Text="Edit" CommandName="Edit" />
            </td>
            <td>
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("DepartmentID") %>' />
            </td>
            <td>
              <asp:Label ID="NameLabel" runat="server" Text='<%#Eval("Name") %>' />
            </td>
            <td>
              <asp:Label ID="GroupNameLabel" runat="server" Text='<%#Eval("GroupName") %>' />
            </td>
          </tr>
        </SelectedItemTemplate>
        <EditItemTemplate>
          <tr class="EditItem">
            <td>
              <asp:Button ID="UpdateButton" runat="server" CommandName="Update" Text="Update" />
              <asp:Button ID="CancelButton" runat="server" CommandName="Cancel" Text="Cancel" />
            </td>
            <td>
              <b>ID</b><br />
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("DepartmentID") %>' />
            </td>
            <td>
              <asp:Label runat="server" ID="NameLabel" AssociatedControlID="NameTextBox" 
                Text="Name" Font-Bold="true"/><br />
              <asp:TextBox ID="NameTextBox" runat="server" Text='<%#Bind("Name") %>' />
            </td>
            <td>
              <asp:Label runat="server" ID="GroupNameLabel" AssociatedControlID="GroupNameTextBox" 
                Text="Group Name" Font-Bold="true" /><br />
              <asp:TextBox ID="GroupNameTextBox" runat="server" 
                Width="200px"
                Text='<%#Bind("GroupName") %>' />
              <br />
            </td>
          </tr>
        </EditItemTemplate>
        <InsertItemTemplate>
          <tr class="InsertItem">
            <td colspan="2">
              <asp:Button ID="InsertButton" runat="server" CommandName="Insert" Text="Insert" />
              <asp:Button ID="CancelButton" runat="server" CommandName="Cancel" Text="Cancel" />
            </td>
            <td>
              <asp:Label runat="server" ID="NameLabel" AssociatedControlID="NameTextBox" 
                Text="Name" Font-Bold="true"/><br />
              <asp:TextBox ID="NameTextBox" runat="server" Text='<%#Bind("Name") %>' /><br />
            </td>
            <td>
              <asp:Label runat="server" ID="GroupNameLabel" AssociatedControlID="GroupNameTextBox" 
                Text="Group Name" Font-Bold="true" /><br />                
              <asp:TextBox ID="GroupNameTextBox" runat="server" Text='<%#Bind("GroupName") %>' />
            </td>
          </tr>
        </InsertItemTemplate>
      </asp:ListView>

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->            
      <asp:SqlDataSource ID="DepartmentsDataSource" runat="server" 
            ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
            SelectCommand="SELECT DepartmentID, Name, GroupName FROM HumanResources.Department"
            UpdateCommand="UPDATE HumanResources.Department 
                SET Name = @Name, GroupName = @GroupName WHERE (DepartmentID = @DepartmentID)"            
            DeleteCommand="DELETE FROM HumanResources.Department 
                WHERE (DepartmentID = @DepartmentID)" 
            InsertCommand="INSERT INTO HumanResources.Department(Name, GroupName) 
                VALUES (@Name, @GroupName)">
      </asp:SqlDataSource>
      
    </form>
  </body>
</html>

Комментарии

В этом разделе.In this topic:

ВступлениеIntroduction

ListView Элемент управления используется для вывода значений из источника данных.The ListView control is used to display the values from a data source. Он напоминает GridView элемент управления, за исключением того, что он отображает данные с помощью определяемых пользователем шаблонов, а не полей строк.It resembles the GridView control, except that it displays data by using user-defined templates instead of row fields. Создание собственных шаблонов обеспечивает большую гибкость в управлении отображением данных.Creating your own templates gives you more flexibility in controlling how the data is displayed.

Для этого раздела доступен проект Visual Studio с исходным кодом: Скачайте.A Visual Studio project with source code is available to accompany this topic: Download.

ListView Элемент управления поддерживает следующие функции:The ListView control supports the following features:

  • Поддержка привязки к элементам управления источника данных, таким SqlDataSourceкак LinqDataSource, и ObjectDataSource.Support for binding to data source controls such as SqlDataSource, LinqDataSource, and ObjectDataSource.

  • Настраиваемый внешний вид с помощью определяемых пользователем шаблонов и стилей.Customizable appearance through user-defined templates and styles.

  • Встроенные возможности сортировки.Built-in sorting capabilities.

  • Встроенные возможности обновления и удаления.Built-in update and delete capabilities.

  • Встроенные возможности вставки.Built-in insert capabilities.

  • Поддержка возможности разбиения по страницам DataPager с помощью элемента управления.Support for paging capabilities by using a DataPager control.

  • Встроенные возможности выбора элементов.Built-in item selection capabilities.

  • Программный доступ к ListView объектной модели для динамического задания свойств, управления событиями и т. д.Programmatic access to the ListView object model to dynamically set properties, handle events, and so on.

  • Несколько ключевых полей.Multiple key fields.

Дополнительные сведения о других элементах управления с привязкой к данным, доступных в ASP.NET, см. в разделе веб-серверные элементы управления с привязкой к данным.To learn about other data-bound controls that are available in ASP.NET, see Data-Bound Web Server Controls.

ШаблоныTemplates

ListView Чтобы элемент управления отображал содержимое, необходимо создать шаблоны для различных частей элемента управления.In order for the ListView control to display content, you must create templates for different parts of the control. ItemTemplate Является обязательным.The ItemTemplate is required. Все остальные шаблоны являются необязательными.All other templates are optional. LayoutTemplate Свойство не является обязательным.The LayoutTemplate property is not required.

Однако необходимо создать шаблон для режима, в котором настроен элемент управления.However, you must create a template for the mode in which the control is configured. Например, ListView для элемента управления, поддерживающего вставку записей, должен InsertItemTemplate быть определен шаблон.For example, a ListView control that supports inserting records must have an InsertItemTemplate template defined. В следующей таблице перечислены шаблоны, которые можно создать для ListView элемента управления.The following table lists the templates that you can create for the ListView control.

Тип шаблонаTemplate type ОписаниеDescription
LayoutTemplate Корневой шаблон, определяющий объект-контейнер table, например элемент, divили span , ItemTemplate который будет содержать содержимое, определенное в шаблоне или GroupTemplate .The root template that defines a container object, such as a table, div, or span element, that will contain the content defined in the ItemTemplate or GroupTemplate template. Он также может содержать DataPager объект.It might also contain a DataPager object.
ItemTemplate Определяет содержимое, привязанное к данным, которое будет отображаться для отдельных элементов.Defines the data-bound content to display for individual items.
ItemSeparatorTemplate Определяет содержимое для отображения между отдельными элементами.Defines the content to render between individual items.
GroupTemplate Определяет объект-контейнер,trнапример строку таблицы (), divили span , ItemTemplate который будет содержать содержимое, определенное в шаблонах и EmptyItemTemplate .Defines a container object, such as a table row (tr), div, or span element, that will contain the content defined in the ItemTemplate and EmptyItemTemplate templates. Количество элементов, отображаемых в группе, задается GroupItemCount свойством.The number of items that are displayed in a group is specified by the GroupItemCount property.
GroupSeparatorTemplate Определяет содержимое для отображения между группами элементов.Defines the content to render between groups of items.
EmptyItemTemplate Определяет содержимое, которое будет отображаться для пустого элемента при GroupTemplate использовании шаблона.Defines the content to render for an empty item when a GroupTemplate template is used. Например, если GroupItemCount свойство имеет значение 5, а общее число элементов, возвращенных из источника данных, равно 8, то последняя группа данных, отображаемая ListView элементом управления, будет содержать три элемента, как указано в ItemTemplate шаблоне, и два элемента. как указано в EmptyItemTemplate шаблоне.For example, if the GroupItemCount property is set to 5, and the total number of items returned from the data source is 8, the last group of data displayed by the ListView control will contain three items as specified by the ItemTemplate template, and two items as specified by the EmptyItemTemplate template.
EmptyDataTemplate Определяет содержимое для отображения, если источник данных не возвращает данные.Defines the content to render if the data source returns no data.
SelectedItemTemplate Определяет содержимое, отображаемое для выбранного элемента данных, чтобы отличать выбранный элемент от других элементов.Defines the content to render for the selected data item to differentiate the selected item from other items.
AlternatingItemTemplate Определяет содержимое, отображаемое для чередующихся элементов, чтобы облегчить различение последовательных элементов.Defines the content to render for alternating items to make it easier to distinguish between consecutive items.
EditItemTemplate Определяет содержимое, отображаемое при редактировании элемента.Defines the content to render when an item is being edited. Шаблон отображается вместо ItemTemplate шаблона редактируемого элемента данных. EditItemTemplateThe EditItemTemplate template is rendered in place of the ItemTemplate template for the data item that is being edited.
InsertItemTemplate Определяет содержимое, которое будет отображено для вставки элемента.Defines the content to render to insert an item. Шаблон отображается вместо ItemTemplate шаблона либо в начале ListView , либо в конце элементов, отображаемых элементом управления. InsertItemTemplateThe InsertItemTemplate template is rendered in place of an ItemTemplate template at either the start or at the end of the items that are displayed by the ListView control. Можно указать место InsertItemTemplate для отображения шаблона с InsertItemPosition помощью свойства ListView элемента управления.You can specify where the InsertItemTemplate template is rendered by using the InsertItemPosition property of the ListView control.

Чтобы отобразить значение поля в шаблоне ItemTemplate, например, используйте выражение привязки данных.To display the value of a field in a template such as ItemTemplate, you use a data-binding expression. Дополнительные сведения о выражениях привязки данных см. в разделе Общие сведения о выражениях привязки данных.For more information about data-binding expressions, see Data-Binding Expressions Overview.

Для привязки элементов управления вводом EditItemTemplate в InsertItemTemplate шаблонах и к полям источника данных можно использовать выражения двусторонней привязки.To bind input controls in the EditItemTemplate and InsertItemTemplate templates to fields of a data source, you can use two-way binding expressions. Это позволяет ListView элементу управления автоматически извлекать значения элемента управления вводом для операции обновления или вставки.This enables the ListView control to automatically extract the values of the input control for an update or insert operation. Выражения двусторонней привязки также позволяют элементам управления вводом в EditItemTemplate автоматически отображать исходные значения полей.Two-way binding expressions also enable input controls in an EditItemTemplate to automatically display the original field values. Дополнительные сведения о выражениях двухсторонней привязки см. в разделе Привязка к базам данных.For more information about two-way binding expressions, see Binding to Databases.

Привязка к источнику данныхBinding to a Data Source

ListView Элемент управления можно привязать к элементу управления источника данных (например, SqlDataSource к элементу управления или ObjectDataSource элементу управления) или System.Collections.IEnumerable к любой System.Data.DataViewколлекции источников данных, реализующей System.Collections.ArrayListинтерфейс, например, System.Collections.Generic.List<T>или других типов коллекций.You can bind the ListView control to a data source control (such as the SqlDataSource control or ObjectDataSource control) or to any data source collection that implements the System.Collections.IEnumerable interface, such as System.Data.DataView, System.Collections.ArrayList, System.Collections.Generic.List<T>, or other collection types. Используйте один из следующих методов, чтобы привязать ListView элемент управления к соответствующему типу источника данных:Use one of the following methods to bind the ListView control to the appropriate data source type:

  • Чтобы выполнить привязку к элементу управления источником данных DataSourceID , присвойте ListView свойству элемента ID управления значение, равное значению элемента управления источника данных.To bind to a data source control, set the DataSourceID property of the ListView control to the ID value of the data source control. ListView Элемент управления автоматически привязывается к заданному элементу управления источником данных и может использовать преимущества возможностей элемента управления источниками данных для выполнения сортировки, вставки, обновления, удаления и разбиения на страницы.The ListView control automatically binds to the specified data source control and can take advantage of the data source control's capabilities to perform sorting, inserting, updating, deleting, and paging functionality. Это предпочтительный метод для привязки к данным.This is the preferred method to bind to data.

  • Чтобы выполнить привязку к источнику данных, System.Collections.IEnumerable реализующему интерфейс, программным образом DataSource задайте ListView для свойства элемента управления источник данных, а затем вызовите DataBind метод.To bind to a data source that implements the System.Collections.IEnumerable interface, programmatically set the DataSource property of the ListView control to the data source, and then call the DataBind method. При использовании этого метода ListView элемент управления не предоставляет встроенные функции сортировки, обновления, удаления и разбиения на страницы.When you use this technique, the ListView control does not provide built-in sorting, updating, deleting, and paging functionality. Эти функции необходимо предоставить с помощью соответствующего события.You must provide this functionality by using the appropriate event.

Дополнительные сведения о привязке данных см. в статье ASP.NET Data Access (схема содержимого).For more information about data binding, see ASP.NET Data Access Content Map.

Примечание

ListView Элемент управления может использоваться для вывода вводимых пользователем данных, которые могут включать вредоносный клиентский скрипт.The ListView control can be used to display user input, which might include malicious client script. Перед отображением в приложении всех сведений, отправляемых с клиента для исполняемого скрипта, инструкций SQL или другого кода, необходимо проверить их.Check any information that is sent from a client for executable script, SQL statements, or other code before you display it in the application. Настоятельно рекомендуется, чтобы значения отображались в формате HTML, если это возможно до того, как они будут показаны в этом элементе управления.We strongly recommend that values be HTML-encoded whenever possible before they are displayed in this control. ASP.NET предоставляет функцию проверки входных запросов, которая помогает блокировать скрипты и HTML-код при вводе данных пользователем.ASP.NET provides an input request validation feature to help block script and HTML in user input. Можно также использовать проверочные элементы управления для проверки вводимых пользователем данных.You can also use validation server controls to check user input. Дополнительные сведения см. в разделе Введение в элементы управления проверки.For more information, see Introduction to the Validation Controls.

Операции с даннымиData Operations

При привязке ListViewэлементауправления к элементу управления источником данных элемент управления может воспользоваться возможностями элемента управления источниками данных и предоставить функции автоматической сортировки, вставки, обновления и удаления. ListViewWhen the ListView control is bound to a data source control, the ListView control can take advantage of the data source control's capabilities and provide automatic sort, insert, update, and delete functionality.

Примечание

ListView Элемент управления может обеспечивать поддержку сортировки, вставки, обновления и удаления с другими типами источников данных.The ListView control can provide support for sorting, inserting, updating, and deleting with other types of data sources. Однако для реализации этих операций необходимо создать код в соответствующем обработчике событий.However, in order to implement these operations, you must create code in an appropriate event handler.

ListView Поскольку элемент управления использует шаблоны, он не позволяет автоматически создавать кнопки для выполнения операций обновления, удаления, вставки, сортировки или выбора.Because the ListView control uses templates, it does not provide a way to automatically generate buttons to perform update, delete, insert, sort, or select operations. Эти кнопки необходимо включить в соответствующий шаблон вручную.You must manually include these buttons in the appropriate template. Элемент управления распознает определенные кнопки CommandName , для свойства которых задано определенное значение. ListViewThe ListView control recognizes certain buttons whose CommandName property is set to a specific value. В следующей таблице перечислены кнопки, ListView распознаваемые элементом управления, и их функции.The following table lists the buttons that the ListView control recognizes and their functions.

КнопкаButton CommandName, значениеCommandName value ОписаниеDescription
ОтменаCancel Отмены"Cancel" Отменяет операцию изменения или вставки.Cancels an edit or insert operation. Вызывает событие ItemCanceling.Raises the ItemCanceling event.
УдалениеDelete "Удалить""Delete" Удаляет текущую запись из источника данных.Deletes the current record from the data source. Вызывает события ItemDeletingи. ItemDeletedRaises the ItemDeleted and ItemDeleting events.
ВыбратьSelect Метьте"Select" SelectedIndex Устанавливает свойство DisplayIndex в значение свойства для элемента.Sets the SelectedIndex property to the DisplayIndex property value for the item. Подготавливает к просмотру шаблон для элемента. SelectedItemTemplateRenders the SelectedItemTemplate template for the item. Вызывает события SelectedIndexChangedи. SelectedIndexChangingRaises the SelectedIndexChanging and SelectedIndexChanged events.
ПравкаEdit Редактор"Edit" Помещает элемент в режим редактирования.Puts the item in edit mode. Подготавливает к просмотру шаблон для элемента. EditItemTemplateRenders the EditItemTemplate template for the item. Создает событие ItemEditing.Raises the ItemEditing event.
InsertInsert Вставляет"Insert" Вставляет привязанные значения из InsertItemTemplate шаблона в источник данных.Inserts the bound values from the InsertItemTemplate template into the data source. Вызывает события ItemInsertedи. ItemInsertingRaises the ItemInserting and ItemInserted events.
ОбновлениеUpdate Обновляют"Update" Обновляет текущую запись в источнике данных связанными значениями из EditItemTemplate шаблона.Updates the current record in the data source with the bound values from the EditItemTemplate template. Вызывает события ItemUpdatedи. ItemUpdatingRaises the ItemUpdating and ItemUpdated events.
СортироватьSort Сортировки"Sort" Сортирует столбцы, перечисленные в CommandArgument свойстве кнопки.Sorts the columns listed in the CommandArgument property of the button. Вызывает события Sortedи. SortingRaises the Sorting and Sorted events.

В отличие от кнопки Удалить (которая немедленно удаляет текущий элемент данных) при нажатии ListView кнопки изменить элемент управления отображает текущий элемент в режиме редактирования.Unlike the Delete button (which deletes the current data item immediately), when the Edit button is clicked, the ListView control displays the current item in edit mode. В режиме редактирования содержимое, содержащееся в EditItemTemplate свойстве, отображается для текущего элемента данных.In edit mode, the content that is contained in the EditItemTemplate property is displayed for the current data item. Как правило, кнопка "Изменить" в шаблоне элемента "Изменить" заменяется кнопкой "Обновить" и "Отмена".Typically, in the edit item template, the Edit button is replaced with an Update and a Cancel button. Элементы управления вводом, которые подходят для типа данных поля (например, TextBox или CheckBox ), также обычно отображают значение поля для изменения пользователем.Input controls that are appropriate for the field's data type (such as a TextBox or CheckBox control) also usually display a field's value for a user to modify. При нажатии кнопки Обновить запись в источнике данных обновляется, а при нажатии кнопки Отмена операция изменения отменяется.Clicking the Update button updates the record in the data source, and clicking the Cancel button cancels the edit operation.

Функция INSERT включается, если InsertItemPosition свойство имеет FirstItem значение или LastItem.The insert functionality is enabled when the InsertItemPosition property is set to FirstItem or LastItem. Это свойство определяет, InsertItemTemplate где будет отображаться шаблон для элемента вставки.This property defines where the InsertItemTemplate template is rendered for the insert item. Шаблон элемента вставки обычно включает кнопку «Вставить» и «Отмена», а также пустые элементы управления вводом, позволяющие пользователям вводить значения для новой записи.The insert item template typically includes an Insert and a Cancel button, and empty input controls are displayed for users to enter the values for the new record. При нажатии кнопки Вставить в источник данных вставляется запись, а при нажатии кнопки Отмена удаляются все поля.Clicking the Insert button inserts the record in the data source, and clicking the Cancel button clears all the fields.

СортировкаSorting

ListView Элемент управления позволяет пользователям сортировать элементы, нажимая кнопку Сортировка.The ListView control enables users to sort the items by clicking the Sort button. Функциональность сортировки определяется в CommandArgument свойстве кнопки, содержащей столбцы для сортировки.Sort functionality is defined in the CommandArgument property of the button that contains the columns to be sorted.

Разбивка на страницыPaging

Вместо отображения всех записей из источника данных в то же время ListView элемент управления может разбивать записи на страницы.Instead of displaying all the records from the data source at the same time, the ListView control can break the records into pages. Чтобы включить разбиение на страницы DataPager , свяжите элемент ListView управления с элементом управления.To enable paging, associate a DataPager control with the ListView control. Затем вставьте DataPager элемент управления LayoutTemplate внутри шаблона.Then insert a DataPager control inside the LayoutTemplate template. Кроме того, если DataPager элемент управления находится ListView за пределами элемента PagedControlID управления, ID присвойте свойству ListView значение элемента управления.Alternatively, if the DataPager control is outside the ListView control, set the PagedControlID property to the ID of the ListView control.

СобытияEvents

В следующей таблице перечислены события, поддерживаемые ListView элементом управления.The following table lists the events that are supported by the ListView control.

событиеEvent ОписаниеDescription
ItemCanceling Возникает, когда нажата кнопка отмены (кнопка со CommandName свойством, равным "Отмена"), но ListView до того, как элемент управления отменяет операцию вставки или изменения.Occurs when the Cancel button (a button with its CommandName property set to "Cancel") is clicked, but before the ListView control cancels the insert or edit operation. Это событие часто используется для прекращения операции отмены.This event is often used to stop the cancel operation.
ItemCommand Происходит при нажатии кнопки в элементе управления ListView.Occurs when a button is clicked in the ListView control. Это событие часто используется для выполнения пользовательской задачи при нажатии кнопки в элементе управления.This event is often used to perform a custom task when a button is clicked in the control.
ItemCreated Происходит при создании нового элемента в ListView элементе управления.Occurs when a new item is created in the ListView control. Это событие часто используется для изменения содержимого элемента при создании элемента.This event is often used to modify the content of an item when the item is created.
ItemDataBound Происходит, когда элемент данных привязан к данным в ListView элементе управления.Occurs when a data item is bound to data in the ListView control. Это событие часто используется для изменения содержимого элемента, когда элемент привязан к данным.This event is often used to modify the content of an item when the item is bound to data.
ItemDeleted Возникает, когда нажата кнопка удаления (кнопка со CommandName свойством "Удалить") DeleteItem или вызывается метод, когда ListView элемент управления удаляет запись из источника данных.Occurs when a Delete button (a button with its CommandName property set to "Delete") is clicked or the DeleteItem method is called, after the ListView control deletes the record from the data source. Это событие часто используется для проверки результатов операции удаления.This event is often used to check the results of the delete operation.
ItemDeleting Возникает, когда нажата кнопка удаления (кнопка со CommandName свойством, равным "Удалить"), DeleteItem или ListView вызывается метод, но до того, как элемент управления удалит запись из источника данных.Occurs when a Delete button (a button with its CommandName property set to "Delete") is clicked or the DeleteItem method is called, but before the ListView control deletes the record from the data source. Это событие часто используется для подтверждения или отмены операции удаления.This event is often used to confirm or cancel the delete operation.
ItemEditing Происходит при нажатии кнопки "Изменить" (кнопка CommandName со свойством, для которой задано значение "Изменить"), ListView но до перехода элемента управления в режим редактирования.Occurs when an Edit button (a button with its CommandName property set to "Edit") is clicked, but before the ListView control enters edit mode. Это событие часто используется для отмены операции редактирования.This event is often used to cancel the editing operation.
ItemInserted Возникает при нажатии кнопки вставки (кнопки со CommandName свойством INSERT) InsertNewItem или при вызове метода, когда ListView элемент управления вставляет новую запись из источника данных.Occurs when an Insert button (a button with its CommandName property set to "Insert") is clicked or the InsertNewItem method is called, after the ListView control inserts the new record from the data source. Это событие часто используется для проверки результатов операции вставки.This event is often used to check the results of the insert operation.
ItemInserting Возникает при нажатии кнопки вставки (кнопки со CommandName свойством INSERT) InsertNewItem или при ListView вызове метода, но до того, как элемент управления вставит запись.Occurs when an Insert button (a button with its CommandName property set to "Insert") is clicked or the InsertNewItem method is called, but before the ListView control inserts the record. Это событие часто используется для отмены операции вставки или изменения или проверки значений нового элемента.This event is often used to cancel the insert operation or change or validate the values of the new item.
ItemUpdated Возникает, когда нажата кнопка обновления (кнопка со CommandName свойством, равным "Обновить"), UpdateItem или вызывается метод, когда ListView элемент управления обновляет запись.Occurs when an Update button (a button with its CommandName property set to "Update") is clicked or the UpdateItem method is called, after the ListView control updates the record. Это событие часто используется для проверки результатов операции обновления.This event is often used to check the results of the update operation.
ItemUpdating Возникает при нажатии кнопки обновления (кнопка со CommandName свойством, равным "Обновить") UpdateItem или при ListView вызове метода, но до того, как элемент управления обновляет запись.Occurs when an Update button (a button with its CommandName property set to "Update") is clicked or the UpdateItem method is called, but before the ListView control updates the record. Это событие часто используется для отмены операции обновления или изменения или проверки значений редактируемого элемента.This event is often used to cancel the updating operation or change or validate the values of the edited item.
LayoutCreated Происходит при создании шаблона LayoutTemplate в элементе управления ListView.Occurs when the LayoutTemplate template is created in a ListView control. Это событие часто используется для выполнения задачи после создания шаблона.This event is often used to perform a task after the template is created.
PagePropertiesChanged Происходит при изменении свойств страницы, после того как элемент управления ListView задает новые значения.Occurs when the page properties change, after the ListView control sets the new values.
PagePropertiesChanging Происходит при изменении свойств страницы данных, но до того, как ListView элемент управления установит новые значения.Occurs when the data-page properties change, but before the ListView control sets the new values.
SelectedIndexChanged Возникает, когда нажата кнопка выбора (кнопка со CommandName свойством, равным "Select") ListView после того, как элемент управления обрабатывает операцию выбора.Occurs when a Select button (a button with its CommandName property set to "Select") is clicked, after the ListView control handles the select operation. Это событие часто используется для выполнения пользовательской задачи после выбора элемента в элементе управления.This event is often used to perform a custom task after an item is selected in the control.
SelectedIndexChanging Происходит при нажатии кнопки выбора (кнопки со CommandName свойством, равным "Select"), но ListView до того, как элемент управления обрабатывает операцию выбора.Occurs when a Select button (a button with its CommandName property set to "Select") is clicked, but before the ListView control handles the select operation. Это событие часто используется для отмены операции SELECT.This event is often used to cancel the select operation.
Sorted Возникает при нажатии кнопки сортировки (кнопки со CommandName свойством, для которой задано значение Sort) Sort или при вызове метода, когда ListView элемент управления обрабатывает операцию сортировки.Occurs when a Sort button (a button with its CommandName property set to "Sort") is clicked or the Sort method is called, after the ListView control handles the sort operation. Это событие обычно используется для выполнения пользовательской задачи после нажатия пользователем кнопки сортировки и сортировки данных.This event is typically used to perform a custom task after a user clicks a Sort button and the data has been sorted.
Sorting Происходит при нажатии кнопки сортировки (кнопки со CommandName свойством, для которой задано значение Sort) Sort или при ListView вызове метода, но до того, как элемент управления обрабатывает операцию сортировки.Occurs when a Sort button (a button with its CommandName property set to "Sort") is clicked or the Sort method is called, but before the ListView control handles the sort operation. Это событие часто используется для отмены операции сортировки или выполнения пользовательской подпрограммы сортировки.This event is often used to cancel the sorting operation or to perform a custom sorting routine.

Декларативный синтаксисDeclarative Syntax

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

Конструкторы

ListView()

Инициализирует новый экземпляр класса ListView.Initializes a new instance of the ListView class.

Свойства

AccessKey

Переопределяет свойство AccessKey.Overrides the AccessKey property. Настройка данного свойства не поддерживается элементом управления ListView.Setting this property is not supported by the ListView control.

Adapter

Возвращает конкретный адаптер браузера для элемента управления.Gets the browser-specific adapter for the control.

(Унаследовано от Control)
AlternatingItemTemplate

Возвращает или задает пользовательское содержимое для переменного элемента данных в элементе управления ListView.Gets or sets the custom content for the alternating data item in a ListView control.

AppRelativeTemplateSourceDirectory

Возвращает или задает относительно приложения виртуальный каталог объекта Page или UserControl, который содержит этот элемент управления.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Унаследовано от Control)
Attributes

Получает коллекцию произвольных атрибутов (только для отрисовки), которые не соответствуют свойствам элемента управления.Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control.

(Унаследовано от WebControl)
BackColor

Переопределяет свойство BackColor.Overrides the BackColor property. Настройка данного свойства не поддерживается элементом управления ListView.Setting this property is not supported by the ListView control.

BindingContainer

Возвращает элемент управления, который содержит привязку данных элемента управления.Gets the control that contains this control's data binding.

(Унаследовано от Control)
BorderColor

Переопределяет свойство BorderColor.Overrides the BorderColor property. Настройка данного свойства не поддерживается элементом управления ListView.Setting this property is not supported by the ListView control.

BorderStyle

Переопределяет свойство BorderStyle.Overrides the BorderStyle property. Настройка данного свойства не поддерживается элементом управления ListView.Setting this property is not supported by the ListView control.

BorderWidth

Переопределяет свойство BorderWidth.Overrides the BorderWidth property. Настройка данного свойства не поддерживается элементом управления ListView.Setting this property is not supported by the ListView control.

ChildControlsCreated

Возвращает значение, которое указывает, созданы ли дочерние элементы управления серверного элемента управления.Gets a value that indicates whether the server control's child controls have been created.

(Унаследовано от Control)
ClientID

Получает идентификатор элемента управления для HTML-разметки, созданной ASP.NET.Gets the control ID for HTML markup that is generated by ASP.NET.

(Унаследовано от Control)
ClientIDMode

Возвращает или задает алгоритм, используемый для создания значения свойства ClientID.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Унаследовано от Control)
ClientIDRowSuffix

Получает или задает имя поля данных, значение которого используется для однозначной идентификации каждой строки данных в элементе управления ListView, если свойство ClientIDMode имеет значение Predictable.Gets or sets the name of the data field whose value is used to uniquely identify each data row of a ListView control when the ClientIDMode property is set to Predictable.

ClientIDRowSuffixDataKeys

Получает значения данных, используемые для однозначной идентификации каждого экземпляра элемента управления с привязкой к данным при формировании платформой ASP.NET значения ClientID.Gets the data values that are used to uniquely identify each instance of a data-bound control when ASP.NET generates the ClientID value.

ClientIDSeparator

Возвращает значение символа разделителя, используемого в свойстве ClientID.Gets a character value representing the separator character used in the ClientID property.

(Унаследовано от Control)
Context

Возвращает объект HttpContext, связанный с серверным элементом управления для текущего веб-запроса.Gets the HttpContext object associated with the server control for the current Web request.

(Унаследовано от Control)
Controls

Возвращает объект ControlCollection, представляющий дочерние элементы управления для элемента управления ListView.Gets a ControlCollection object that represents the child controls of the ListView control.

ControlStyle

Возвращает или задает стиль серверного веб-элемента управления.Gets the style of the Web server control. Это свойство используется преимущественно разработчиками элементов управления.This property is used primarily by control developers.

(Унаследовано от WebControl)
ControlStyleCreated

Возвращает значение, определяющее, был ли объект Style создан для свойства ControlStyle.Gets a value indicating whether a Style object has been created for the ControlStyle property. Этот свойство в основном используется разработчиками элементов управления.This property is primarily used by control developers.

(Унаследовано от WebControl)
ConvertEmptyStringToNull

Возвращает или задает значение, показывающее, преобразовываются ли пустые строковые значения ("") автоматически в значения NULL, когда в источнике данных обновляется поле данных.Gets or sets a value that indicates whether empty string values ("") are automatically converted to null values when the data field is updated in the data source.

CssClass

Переопределяет свойство CssClass.Overrides the CssClass property. Настройка данного свойства не поддерживается элементом управления ListView.Setting this property is not supported by the ListView control.

DataItemContainer

Возвращает ссылку на контейнер именования, если контейнер именования реализует IDataItemContainer.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Унаследовано от Control)
DataKeyNames

Возвращает или задает массив, содержащий имена первичных ключевых полей для элементов, отображенных в элементе управления ListView.Gets or sets an array that contains the names of the primary key fields for the items displayed in a ListView control.

DataKeys

Возвращает коллекцию объектов DataKey, представляющих значение ключа данных для каждого элемента в элементе управления ListView.Gets a collection of DataKey objects that represent the data-key value for each item in a ListView control.

DataKeysContainer

Возвращает ссылку на контейнер именования, если контейнер именования реализует IDataKeysControl.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Унаследовано от Control)
DataMember

Возвращает или задает имя списка данных, к которому выполняется привязка элемента управления с привязкой к данным, в случае наличия в источнике данных нескольких отдельных списков элементов данных.Gets or sets the name of the list of data that the data-bound control binds to, in cases where the data source contains more than one distinct list of data items.

(Унаследовано от DataBoundControl)
DataSource

Получает или задает объект, из которого элемент управления, присоединенный к данным, извлекает свои данные.Gets or sets the object from which the data-bound control retrieves its list of data items.

(Унаследовано от BaseDataBoundControl)
DataSourceID

Получает или задает ID элемента управления, из которого элемент управления, присоединенный к данным, извлекает свои данные.Gets or sets the ID of the control from which the data-bound control retrieves its list of data items.

(Унаследовано от DataBoundControl)
DataSourceObject

Возвращает объект, реализующий интерфейс IDataSource, который предоставляет доступ к содержимому данных объекта.Gets an object that implements the IDataSource interface, which provides access to the object's data content.

(Унаследовано от DataBoundControl)
DeleteMethod

Получает или задает имя метода, вызываемого для удаления данных.Gets or sets the name of the method to call in order to delete data.

DesignMode

Возвращает значение, указывающее, используется ли элемент управления на поверхности разработки.Gets a value indicating whether a control is being used on a design surface.

(Унаследовано от Control)
EditIndex

Возвращает или задает индекс для редактируемого элемента.Gets or sets the index of the item being edited.

EditItem

Возвращает элемент, который находится в режиме редактирования в элементе управления ListView.Gets the item that is in edit mode in a ListView control.

EditItemTemplate

Возвращает или задает пользовательское содержимое для элемента в режиме редактирования.Gets or sets the custom content for the item in edit mode.

EmptyDataTemplate

Возвращает или задает пользовательское содержимое для пустого шаблона, который преобразовывается для просмотра, когда элемент управления ListView привязывается к источнику данных, не содержащему записи.Gets or sets the user-defined content for the empty template that is rendered when a ListView control is bound to a data source that does not contain any records.

EmptyItemTemplate

Возвращает или задает пользовательское содержимое для пустого элемента, который преобразовывается для просмотра в элементе управления ListView, когда в последней строке текущей страницы данных больше нет отображаемых элементов данных.Gets or sets the user-defined content for the empty item that is rendered in a ListView control when there are no more data items to display in the last row of the current data page.

Enabled

Возвращает или задает значение, определяющее, включен ли серверный веб-элемент управления.Gets or sets a value indicating whether the Web server control is enabled.

(Унаследовано от WebControl)
EnableModelValidation

Получает или задает значение, указывающее, будет ли проверяющий элемент управления обрабатывать исключения, происходящие во время операций вставки или обновления.Gets or sets a value that indicates whether a validator control will handle exceptions that occur during insert or update operations.

EnablePersistedSelection

Получает или задает значение, указывающее, сохраняется ли выделение строки при использовании пользовательской страницей данных элемента управления с привязкой к данным.Gets or sets a value that indicates whether row selection persists when a user pages through data in a data-bound control.

EnableTheming

Возвращает или задает значение, указывающее, применяются ли темы к этому элементу управления.Gets or sets a value indicating whether themes apply to this control.

(Унаследовано от WebControl)
EnableViewState

Получает или задает значение, указывающее запрашивающему клиенту, сохраняет ли серверный элемент управления состояние представления и состояние представления своих дочерних элементов управления.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(Унаследовано от Control)
Events

Возвращает список делегатов обработчиков событий элемента управления.Gets a list of event handler delegates for the control. Это свойство доступно только для чтения.This property is read-only.

(Унаследовано от Control)
Font

Переопределяет свойство Font.Overrides the Font property. Для элемента управления ListView данное свойство не поддерживается.This property is not supported by the ListView control.

ForeColor

Переопределяет свойство ForeColor.Overrides the ForeColor property. Настройка данного свойства не поддерживается элементом управления ListView.Setting this property is not supported by the ListView control.

GroupItemCount

Возвращает или задает количество элементов, которые отображаются в группе в элементе управления ListView.Gets or sets the number of items to display per group in a ListView control.

GroupPlaceholderID

Возвращает или задает идентификатор для местозаполнителя группы в элементе управления ListView.Gets or sets the ID for the group placeholder in a ListView control.

GroupSeparatorTemplate

Возвращает или задает определенное пользователем содержимое для разделителя между группами в элементе управления ListView.Gets or sets the user-defined content for the separator between groups in a ListView control.

GroupTemplate

Возвращает или задает определенное пользователем содержимое контейнера группы в элементе управления ListView.Gets or sets the user-defined content for the group container in a ListView control.

HasAttributes

Получает значение, определяющие наличие атрибутов у элемента управления.Gets a value indicating whether the control has attributes set.

(Унаследовано от WebControl)
HasChildViewState

Возвращает значение, которое указывает на наличие сохраненных параметров состояния представления у дочернего элемента серверного элемента управления.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Унаследовано от Control)
Height

Переопределяет свойство Height.Overrides the Height property. Настройка данного свойства не поддерживается элементом управления ListView.Setting this property is not supported by the ListView control.

ID

Возвращает или задает программный идентификатор, назначенный серверному элементу управления.Gets or sets the programmatic identifier assigned to the server control.

(Унаследовано от Control)
IdSeparator

Возвращает символ, используемый для разделения идентификаторов элементов управления.Gets the character used to separate control identifiers.

(Унаследовано от Control)
Initialized

Получает значение, указывающее, был ли проинициализирован элемент управления, присоединенный к данным.Gets a value indicating whether the data-bound control has been initialized.

(Унаследовано от BaseDataBoundControl)
InsertItem

Возвращает элемент вставки для элемента управления ListView.Gets the insert item of a ListView control.

InsertItemPosition

Возвращает или задает расположение шаблона InsertItemTemplate, когда он преобразовывается для просмотра в составе элемента управления ListView.Gets or sets the location of the InsertItemTemplate template when it is rendered as part of the ListView control.

InsertItemTemplate

Возвращает или задает пользовательское содержимое для элемента вставки в элементе управления ListView.Gets or sets the custom content for an insert item in the ListView control.

InsertMethod

Получает или задает имя метода, вызываемого для вставки данных.Gets or sets the name of the method to call in order to insert data.

IsBoundUsingDataSourceID

Получает значение, указывающее, установлено ли свойство DataSourceID.Gets a value indicating whether the DataSourceID property is set.

(Унаследовано от BaseDataBoundControl)
IsChildControlStateCleared

Возвращает значение, указывающее, имеют ли элементы управления в этом элементе управления состояние элемента управления.Gets a value indicating whether controls contained within this control have control state.

(Унаследовано от Control)
IsDataBindingAutomatic

Получает значение, указывающее, является ли привязка данных автоматической.Gets a value that indicates whether data binding is automatic.

(Унаследовано от BaseDataBoundControl)
IsEnabled

Возвращает значение, определяющее, включен ли элемент управления.Gets a value indicating whether the control is enabled.

(Унаследовано от WebControl)
IsTrackingViewState

Возвращает значение, отражающее сохранение изменений в состояние представления серверного элемента управления.Gets a value that indicates whether the server control is saving changes to its view state.

(Унаследовано от Control)
IsUsingModelBinders

Получает значение, указывающее, используется ли привязка модели.Gets a value that indicates whether model binding is in use.

IsViewStateEnabled

Возвращает значение, указывающее, используется ли состояние представления для этого элемента управления.Gets a value indicating whether view state is enabled for this control.

(Унаследовано от Control)
ItemPlaceholderID

Возвращает или задает идентификатор для местозаполнителя элемента в элементе управления ListView.Gets or sets the ID for the item placeholder in a ListView control.

Items

Возвращает коллекцию объектов ListViewDataItem, представляющих элементы данных на текущей странице данных в элементе управления ListView.Gets a collection of ListViewDataItem objects that represent the data items of the current page of data in a ListView control.

ItemSeparatorTemplate

Возвращает или задает пользовательское содержимое для разделителя между элементами в элементе управления ListView.Gets or sets the custom content for the separator between the items in a ListView control.

ItemTemplate

Возвращает или задает пользовательское содержимое для элемента данных в элементе управления ListView.Gets or sets the custom content for the data item in a ListView control.

ItemType

Получает или задает имя типа элемента данных для привязки строго типизированных данных.Gets or sets the name of the data item type for strongly typed data binding.

(Унаследовано от DataBoundControl)
LayoutTemplate

Возвращает или задает пользовательское содержимое для корневого контейнера в элементе управления ListView.Gets or sets the custom content for the root container in a ListView control.

LoadViewStateByID

Возвращает значение, указывающее, участвует ли элемент управления в загрузке состояния представления ID вместо индекса.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(Унаследовано от Control)
MaximumRows

Возвращает максимальное количество элементов, отображаемых на одной странице элемента управления ListView.Gets the maximum number of items to display on a single page of the ListView control.

NamingContainer

Возвращает ссылку на контейнер именования элемента управления, создающий уникальное пространство имен для различения серверных элементов управления с одинаковыми значениями свойства ID.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(Унаследовано от Control)
Page

Возвращает ссылку на экземпляр Page, содержащий серверный элемент управления.Gets a reference to the Page instance that contains the server control.

(Унаследовано от Control)
Parent

Возвращает ссылку на родительский элемент управления серверного элемента управления в иерархии элементов управления страницы.Gets a reference to the server control's parent control in the page control hierarchy.

(Унаследовано от Control)
RenderingCompatibility

Возвращает значение, которое задает версию ASP.NET, с которой совместим созданный HTML.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Унаследовано от Control)
RequiresDataBinding

Получает или задает значение, указывающее, должен ли вызываться метод DataBind().Gets or sets a value indicating whether the DataBind() method should be called.

(Унаследовано от BaseDataBoundControl)
SelectArguments

Возвращает объект DataSourceSelectArguments, который используется элементом управления с привязкой к данным при извлечении данных из элемента управления источником данных.Gets a DataSourceSelectArguments object that the data-bound control uses when retrieving data from a data source control.

(Унаследовано от DataBoundControl)
SelectedDataKey

Возвращает значение ключа данных выбранного элемента в элементе управления ListView.Gets the data-key value for the selected item in a ListView control.

SelectedIndex

Возвращает или задает индекс выбранного элемента в элементе управления ListView.Gets or sets the index of the selected item in a ListView control.

SelectedItemTemplate

Возвращает или задает пользовательское содержимое для выбранного элемента в элементе управления ListView.Gets or sets the custom content for the selected item in a ListView control.

SelectedPersistedDataKey

Получает или задает значение ключа данных для сохраненного выбранного элемента в элементе управления с привязкой к данным.Gets or sets the data-key value for the persisted selected item in a data-bound control.

SelectedValue

Возвращает значение ключа данных выбранного элемента в элементе управления ListView.Gets the data-key value of the selected item in a ListView control.

SelectMethod

Имя метода, вызываемого для чтения данных.The name of the method to call in order to read data.

(Унаследовано от DataBoundControl)
Site

Возвращает сведения о контейнере, который содержит текущий элемент управления при визуализации на поверхности конструктора.Gets information about the container that hosts the current control when rendered on a design surface.

(Унаследовано от Control)
SkinID

Возвращает или задает обложку, применяемую к элементу управления.Gets or sets the skin to apply to the control.

(Унаследовано от WebControl)
SortDirection

Возвращает направление сортировки для сортируемого поля (полей).Gets the sort direction of the field or fields that are being sorted.

SortExpression

Возвращает выражение сортировки, связанное с сортируемым полем (полями).Gets the sort expression that is associated with the field or fields that are being sorted.

StartRowIndex

Возвращает индекс первой записи, которая отображается на странице данных в элементе управления ListView.Gets the index of the first record that is displayed on a page of data in the ListView control.

Style

Возвращает коллекцию атрибутов текста, которые будут отображены в виде атрибута стиля на внешнем теге серверного веб-элемента управления.Gets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control.

(Унаследовано от WebControl)
SupportsDisabledAttribute

Получает значение, указывающее, должен ли элемент управления устанавливать для атрибута disabled отрисовываемого элемента HTML значение disabled, если для свойства элемента управления IsEnabled задано значение false.Gets a value that indicates whether the control should set the disabled attribute of the rendered HTML element to "disabled" when the control's IsEnabled property is false.

(Унаследовано от BaseDataBoundControl)
TabIndex

Переопределяет свойство TabIndex.Overrides the TabIndex property. Настройка данного свойства не поддерживается элементом управления ListView.Setting this property is not supported by the ListView control.

TagKey

Возвращает значение HtmlTextWriterTag, которое соответствует этому элементу управления веб-сервера.Gets the HtmlTextWriterTag value that corresponds to this Web server control. Это свойство используется преимущественно разработчиками элементов управления.This property is used primarily by control developers.

(Унаследовано от WebControl)
TagName

Возвращает имя тега элемента управления.Gets the name of the control tag. Это свойство используется преимущественно разработчиками элементов управления.This property is used primarily by control developers.

(Унаследовано от WebControl)
TemplateControl

Возвращает или задает ссылку на шаблон, содержащий этот элемент управления.Gets or sets a reference to the template that contains this control.

(Унаследовано от Control)
TemplateSourceDirectory

Возвращает виртуальный каталог Page или UserControl, содержащий текущий серверный элемент управления.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Унаследовано от Control)
ToolTip

Переопределяет свойство ToolTip.Overrides the ToolTip property. Настройка данного свойства не поддерживается элементом управления ListView.Setting this property is not supported by the ListView control.

UniqueID

Возвращает уникальный идентификатор серверного элемента управления в иерархии.Gets the unique, hierarchically qualified identifier for the server control.

(Унаследовано от Control)
UpdateMethod

Получает или задает имя метода, вызываемого для обновления данных.Gets or sets the name of the method to call in order to update data.

ValidateRequestMode

Возвращает или задает значение, указывающее, проверяет ли элемент управления полученный из браузера клиентский ввод на предмет потенциально опасных значений.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Унаследовано от Control)
ViewState

Возвращает словарь сведений о состоянии, позволяющих сохранять и восстанавливать состояние представления серверного элемента управления при нескольких запросах одной и той же страницы.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(Унаследовано от Control)
ViewStateIgnoresCase

Возвращает значение, указывающее, является ли объект StateBag нечувствительным к регистру.Gets a value that indicates whether the StateBag object is case-insensitive.

(Унаследовано от Control)
ViewStateMode

Возвращает или задает режим состояния представления данного элемента управления.Gets or sets the view-state mode of this control.

(Унаследовано от Control)
Visible

Получает или задает значение, указывающее, отрисовывается ли серверный элемент управления как пользовательский интерфейс на странице.Gets or sets a value that indicates whether a server control is rendered as UI on the page.

(Унаследовано от Control)
Width

Переопределяет свойство Width.Overrides the Width property. Настройка данного свойства не поддерживается элементом управления ListView.Setting this property is not supported by the ListView control.

Методы

AddAttributesToRender(HtmlTextWriter)

Добавляет атрибуты и стили HTML, которые должны быть отображены в указанном элементе управления HtmlTextWriterTag.Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriterTag. Этот метод используется в основном разработчиками элементов управления.This method is used primarily by control developers.

(Унаследовано от WebControl)
AddControlToContainer(Control, Control, Int32)

Добавляет указанный элемент управления к указанному контейнеру.Adds the specified control to the specified container.

AddedControl(Control, Int32)

Вызывается после добавления дочернего элемента управления в коллекцию Controls объекта Control.Called after a child control is added to the Controls collection of the Control object.

(Унаследовано от Control)
AddParsedSubObject(Object)

Уведомляет серверный элемент управления, что элемент XML или HTML был проанализирован, и добавляет элемент в серверный элемент управления объекта ControlCollection.Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(Унаследовано от Control)
ApplyStyle(Style)

Копирует любой непустой элемент указанного стиля в элемент управления Веба, перезаписывая уже существующие элементы стиля.Copies any nonblank elements of the specified style to the Web control, overwriting any existing style elements of the control. Этот метод, в основном, используется разработчиками элементов управления.This method is primarily used by control developers.

(Унаследовано от WebControl)
ApplyStyleSheetSkin(Page)

Применяет свойства стиля, определенные в таблице стилей страницы, к элементу управления.Applies the style properties defined in the page style sheet to the control.

(Унаследовано от Control)
BeginRenderTracing(TextWriter, Object)

Запускает трассировку во время разработки данных отрисовки.Begins design-time tracing of rendering data.

(Унаследовано от Control)
BuildProfileTree(String, Boolean)

Собирает сведения о серверном элементе управления и доставляет их свойству Trace, которое отображается при включенной на странице трассировке.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Унаследовано от Control)
ClearCachedClientID()

Задает для кэшированного свойства ClientID значение null.Sets the cached ClientID value to null.

(Унаследовано от Control)
ClearChildControlState()

Удаляет сведения о состоянии элемента управления для дочерних элементов управления серверного элемента управления.Deletes the control-state information for the server control's child controls.

(Унаследовано от Control)
ClearChildState()

Удаляет сведения о состоянии элемента управления и состоянии представления для всех дочерних элементов серверного элемента управления.Deletes the view-state and control-state information for all the server control's child controls.

(Унаследовано от Control)
ClearChildViewState()

Удаляет сведения о состоянии представления для всех дочерних элементов серверного элемента управления.Deletes the view-state information for all the server control's child controls.

(Унаследовано от Control)
ClearEffectiveClientIDMode()

Задает для свойства ClientIDMode текущего экземпляра элемента управления и любых его дочерних элементов управления значение Inherit.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Унаследовано от Control)
ConfirmInitState()

Устанавливает исходное состояние элемента управления, присоединенного к данным.Sets the initialized state of the data-bound control.

(Унаследовано от BaseDataBoundControl)
CopyBaseAttributes(WebControl)

Копирует не инкапсулированные объектом Style свойства из указанного серверного веб-элемента управления веб-сервера в элемент управления веб-сервера, откуда вызывается этот метод.Copies the properties not encapsulated by the Style object from the specified Web server control to the Web server control that this method is called from. Этот метод используется в основном разработчиками элементов управления.This method is used primarily by control developers.

(Унаследовано от WebControl)
CreateChildControls()

Создает иерархию элементов управления для обработки элемента управления ListView, основанного на значениях, которые хранятся в состоянии представления.Creates the control hierarchy that is used to render the ListView control, based on the values that are stored in view state.

CreateChildControls(IEnumerable, Boolean)

Создает иерархию элементов управления для обработки элемента управления ListView с использованием указанного источника данных.Creates the control hierarchy that is used to render the ListView control by using the specified data source.

CreateControlCollection()

Создает новый объект ControlCollection для хранения дочерних элементов управления (литеральных и серверных) серверного элемента управления.Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.

(Унаследовано от Control)
CreateControlStyle()

Создает стиль, используемый по умолчанию для элемента управления.Creates the default style for the control.

CreateDataItem(Int32, Int32)

Создает элемент данных в элементе управления ListView.Creates a data item in the ListView control.

CreateDataSourceSelectArguments()

Создает объект DataSourceSelectArguments, содержащий аргументы для передачи в источник данных.Creates the DataSourceSelectArguments object that contains the arguments that are passed to the data source.

CreateEmptyDataItem()

Создает шаблон EmptyDataTemplate в элементе управления ListView.Creates the EmptyDataTemplate template in the ListView control.

CreateEmptyItem()

Создает пустой элемент в элементе управления ListView.Creates an empty item in the ListView control.

CreateInsertItem()

Создает элемент вставки в элементе управления ListView.Creates an insert item in the ListView control.

CreateItem(ListViewItemType)

Создает объект ListViewItem указанного типа.Creates a ListViewItem object with the specified type.

CreateItemsInGroups(ListViewPagedDataSource, Boolean, InsertItemPosition, ArrayList)

Создает иерархию элементов управления ListView в группах.Creates the ListView control hierarchy in groups.

CreateItemsWithoutGroups(ListViewPagedDataSource, Boolean, InsertItemPosition, ArrayList)

Создает иерархию элементов управления ListView без групп.Creates the ListView control hierarchy without groups.

CreateLayoutTemplate()

Создает корневой контейнер в элементе управления ListView.Creates the root container in the ListView control.

CreateSuffixArrayList(ListViewPagedDataSource, ArrayList)

Создает массив суффиксов, которые используются, когда ASP.NET создает значение ClientID.Creates an array of suffixes for ASP.NET to use when it generates the ClientID value.

DataBind()

Связывает источник данных с вызывающим серверным элементом управления и всеми его дочерними элементами управления.Binds a data source to the invoked server control and all its child controls.

(Унаследовано от BaseDataBoundControl)
DataBind(Boolean)

Привязывает источник данных к вызванному серверному элементу управления и всем его дочерними элементами управления с возможностью вызова события DataBinding.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Унаследовано от Control)
DataBindChildren()

Привязывает источник данных к дочерним элементам управления серверного элемента управления.Binds a data source to the server control's child controls.

(Унаследовано от Control)
DeleteItem(Int32)

Удаляет из источника данных запись по указанному индексу.Deletes the record at the specified index from the data source.

Dispose()

Включает серверный элемент управления для выполнения окончательной чистки до освобождения памяти.Enables a server control to perform final clean up before it is released from memory.

(Унаследовано от Control)
EndRenderTracing(TextWriter, Object)

Завершает трассировку во время разработки данных отрисовки.Ends design-time tracing of rendering data.

(Унаследовано от Control)
EnsureChildControls()

Определяет наличие у серверного элемента управления дочерних элементов управления.Determines whether the server control contains child controls. Если дочерних элементов управления нет, они будут созданы.If it does not, it creates child controls.

(Унаследовано от Control)
EnsureDataBound()

Вызывает метод DataBind(), если установлено свойство DataSourceID и элемент управления, присоединенный к данным, помечен, как требующий привязки.Calls the DataBind() method if the DataSourceID property is set and the data-bound control is marked to require binding.

(Унаследовано от BaseDataBoundControl)
EnsureID()

Создает идентификатор для элементов управления, которые не имеют назначенного идентификатора.Creates an identifier for controls that do not have an identifier assigned.

(Унаследовано от Control)
EnsureLayoutTemplate()

Обеспечивает правильное создание содержимого LayoutTemplate в элементе управления ListView.Ensures that the LayoutTemplate content is correctly created in the ListView control.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
ExtractItemValues(IOrderedDictionary, ListViewItem, Boolean)

Возвращает значения каждого поля, объявленного в указанном элементе, и сохраняет их в указанном объекте IOrderedDictionary.Retrieves the values of each field that is declared in the specified item, and stores them in the specified IOrderedDictionary object.

FindControl(String)

Выполняет поиск серверного элемента управления с заданным параметром id в текущем контейнере именования.Searches the current naming container for a server control with the specified id parameter.

(Унаследовано от Control)
FindControl(String, Int32)

Выполняет поиск в текущем контейнере именования серверного элемента управления с указанным id и целым числом, указанным в параметре pathOffset, который содействует поиску.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Эту версию метода FindControl не следует переопределять.You should not override this version of the FindControl method.

(Унаследовано от Control)
FindPlaceholder(String, Control)

Выполняет поиск указанного контейнера для элемента управления с указанным идентификатором.Searches the specified container for a control that has the specified identifier.

Focus()

Задает фокус ввода на элемент управления.Sets input focus to a control.

(Унаследовано от Control)
GetData()

Извлекает объект DataSourceView, используемый элементом управления с привязкой к данным для выполнения операций с данными.Retrieves a DataSourceView object that the data-bound control uses to perform data operations.

(Унаследовано от DataBoundControl)
GetDataSource()

Извлекает интерфейс IDataSource, с которым связан элемент управления с привязкой к данным, если таковой существует.Retrieves the IDataSource interface that the data-bound control is associated with, if any.

(Унаследовано от DataBoundControl)
GetDesignModeState()

Возвращает данные времени разработки для элемента управления.Gets design-time data for a control.

(Унаследовано от Control)
GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetRouteUrl(Object)

Возвращает URL-адрес, соответствующий набору параметров маршрута.Gets the URL that corresponds to a set of route parameters.

(Унаследовано от Control)
GetRouteUrl(RouteValueDictionary)

Возвращает URL-адрес, соответствующий набору параметров маршрута.Gets the URL that corresponds to a set of route parameters.

(Унаследовано от Control)
GetRouteUrl(String, Object)

Возвращает URL-адрес, соответствующий набору параметров маршрута и имени маршрута.Gets the URL that corresponds to a set of route parameters and a route name.

(Унаследовано от Control)
GetRouteUrl(String, RouteValueDictionary)

Возвращает URL-адрес, соответствующий набору параметров маршрута и имени маршрута.Gets the URL that corresponds to a set of route parameters and a route name.

(Унаследовано от Control)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
GetUniqueIDRelativeTo(Control)

Возвращает часть с префиксом свойства UniqueID указанного элемента управления.Returns the prefixed portion of the UniqueID property of the specified control.

(Унаследовано от Control)
HasControls()

Определяет наличие у серверного элемента управления дочерних элементов управления.Determines if the server control contains any child controls.

(Унаследовано от Control)
HasEvents()

Возвращает значение, указывающее, регистрируются ли события для элемента управления или каких-либо дочерних элементов управления.Returns a value indicating whether events are registered for the control or any child controls.

(Унаследовано от Control)
InsertNewItem(Boolean)

Вставляет текущую запись в источник данных.Inserts the current record in the data source.

InstantiateEmptyDataTemplate(Control)

Заполняет указанный объект Control с использованием дочерних элементов управления, которые содержатся в шаблоне EmptyDataTemplate.Populates the specified Control object by using the child controls that are contained in the EmptyDataTemplate template.

InstantiateEmptyItemTemplate(Control)

Заполняет указанный объект Control с использованием дочерних элементов управления, которые содержатся в шаблоне EmptyItemTemplate.Populates the specified Control object by using the child controls that are contained in the EmptyItemTemplate template.

InstantiateGroupSeparatorTemplate(Control)

Заполняет указанный объект Control с использованием дочерних элементов управления, которые содержатся в шаблоне GroupSeparatorTemplate.Populates the specified Control object by using the child controls that are contained in the GroupSeparatorTemplate template.

InstantiateGroupTemplate(Control)

Заполняет указанный объект Control с использованием дочерних элементов управления, которые содержатся в шаблоне GroupTemplate.Populates the specified Control object by using the child controls that are contained in the GroupTemplate template.

InstantiateInsertItemTemplate(Control)

Заполняет указанный объект Control с использованием дочерних элементов управления, которые содержатся в шаблоне InsertItemTemplate.Populates the specified Control object by using the child controls that are contained in the InsertItemTemplate template.

InstantiateItemSeparatorTemplate(Control)

Заполняет указанный объект Control с использованием дочерних элементов управления, которые содержатся в шаблоне ItemSeparatorTemplate.Populates the specified Control object by using the child controls that are contained in the ItemSeparatorTemplate template.

InstantiateItemTemplate(Control, Int32)

Заполняет указанный объект Control с использованием дочерних элементов управления из одного из шаблонов элементов управления ListView.Populates the specified Control object by using child controls from one of the ListView control templates.

IsLiteralContent()

Определяет наличие у серверного элемента управления только текстового содержимого.Determines if the server control holds only literal content.

(Унаследовано от Control)
LoadControlState(Object)

Загружает состояние свойств элемента управления ListView, которое следует сохранить, даже если свойство EnableViewState имеет значение false.Loads the state of the properties in the ListView control that must be persisted, even when the EnableViewState property is set to false.

LoadViewState(Object)

Загружает предварительно сохраненное состояние представления элемента управления ListView.Loads the previously saved view state of the ListView control.

MapPathSecure(String)

Извлекает физический путь, к которому ведет виртуальный путь (абсолютный или относительный).Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Унаследовано от Control)
MarkAsDataBound()

Задает в данных о состоянии представления состояние элемента управления, соответствующее успешной привязке к данным.Sets the state of the control in view state as successfully bound to data.

(Унаследовано от DataBoundControl)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
MergeStyle(Style)

Копирует любой непустой элемент указанного стиля в элемент управления Веба, но не перезаписывает уже существующие элементы стиля.Copies any nonblank elements of the specified style to the Web control, but will not overwrite any existing style elements of the control. Этот метод используется в основном разработчиками элементов управления.This method is used primarily by control developers.

(Унаследовано от WebControl)
OnBubbleEvent(Object, EventArgs)

Определяет, должно ли обрабатываться событие для элемента управления ListView.Determines whether an event for the ListView control should be handled.

OnCreatingModelDataSource(CreatingModelDataSourceEventArgs)

Создает событие CreatingModelDataSource.Raises the CreatingModelDataSource event.

(Унаследовано от DataBoundControl)
OnDataBinding(EventArgs)

Вызывает событие DataBinding.Raises the DataBinding event.

(Унаследовано от Control)
OnDataBound(EventArgs)

Создает событие DataBound.Raises the DataBound event.

(Унаследовано от BaseDataBoundControl)
OnDataPropertyChanged()

Выполняет повторную привязку элемента управления к своим данным после того, как изменилось одно из свойств, идентифицирующих источник данных.Rebinds the data-bound control to its data after one of the base data source identification properties changes.

(Унаследовано от DataBoundControl)
OnDataSourceViewChanged(Object, EventArgs)

Вызывает событие DataSourceViewChanged.Raises the DataSourceViewChanged event.

(Унаследовано от DataBoundControl)
OnInit(EventArgs)

Вызывает событие Init.Raises the Init event.

OnItemCanceling(ListViewCancelEventArgs)

Вызывает событие ItemCanceling.Raises the ItemCanceling event.

OnItemCommand(ListViewCommandEventArgs)

Вызывает событие ItemCommand.Raises the ItemCommand event.

OnItemCreated(ListViewItemEventArgs)

Вызывает событие ItemCreated.Raises the ItemCreated event.

OnItemDataBound(ListViewItemEventArgs)

Вызывает событие ItemDataBound.Raises the ItemDataBound event.

OnItemDeleted(ListViewDeletedEventArgs)

Вызывает событие ItemDeleted.Raises the ItemDeleted event.

OnItemDeleting(ListViewDeleteEventArgs)

Вызывает событие ItemDeleting.Raises the ItemDeleting event.

OnItemEditing(ListViewEditEventArgs)

Вызывает событие ItemEditing.Raises the ItemEditing event.

OnItemInserted(ListViewInsertedEventArgs)

Вызывает событие ItemInserted.Raises the ItemInserted event.

OnItemInserting(ListViewInsertEventArgs)

Вызывает событие ItemInserting.Raises the ItemInserting event.

OnItemUpdated(ListViewUpdatedEventArgs)

Вызывает событие ItemUpdated.Raises the ItemUpdated event.

OnItemUpdating(ListViewUpdateEventArgs)

Создает событие ItemUpdating.Raises the ItemUpdating event.

OnLayoutCreated(EventArgs)

Создает событие LayoutCreated.Raises the LayoutCreated event.

OnLoad(EventArgs)

Обрабатывает событие Load.Handles the Load event.

(Унаследовано от DataBoundControl)
OnPagePreLoad(Object, EventArgs)

Устанавливает исходное состояние элемента управления, привязанного к данным, перед его загрузкой.Sets the initialized state of the data-bound control before the control is loaded.

(Унаследовано от DataBoundControl)
OnPagePropertiesChanged(EventArgs)

Вызывает событие PagePropertiesChanged.Raises the PagePropertiesChanged event.

OnPagePropertiesChanging(PagePropertiesChangingEventArgs)

Вызывает событие PagePropertiesChanging.Raises the PagePropertiesChanging event.

OnPreRender(EventArgs)

Обрабатывает событие PreRender.Handles the PreRender event.

(Унаследовано от BaseDataBoundControl)
OnSelectedIndexChanged(EventArgs)

Создает событие SelectedIndexChanged.Raises the SelectedIndexChanged event.

OnSelectedIndexChanging(ListViewSelectEventArgs)

Вызывает событие SelectedIndexChanging.Raises the SelectedIndexChanging event.

OnSorted(EventArgs)

Создает событие Sorted.Raises the Sorted event.

OnSorting(ListViewSortEventArgs)

Создает событие Sorting.Raises the Sorting event.

OnTotalRowCountAvailable(PageEventArgs)

Создает событие IPageableItemContainer.TotalRowCountAvailable.Raises the IPageableItemContainer.TotalRowCountAvailable event.

OnUnload(EventArgs)

Создает событие Unload.Raises the Unload event.

(Унаследовано от Control)
OpenFile(String)

Возвращает Stream, используемое для чтения файла.Gets a Stream used to read a file.

(Унаследовано от Control)
PerformDataBinding(IEnumerable)

Привязывает элемент управления ListView к указанному источнику данных.Binds the ListView control to the specified data source.

PerformSelect()

Извлекает данные из связанного источника данных.Retrieves data from the associated data source.

RaiseBubbleEvent(Object, EventArgs)

Присваивает родительскому элементу управления все источники события и сведения о них.Assigns any sources of the event and its information to the control's parent.

(Унаследовано от Control)
RemovedControl(Control)

Вызывается после удаления дочернего элемента управления из коллекции Controls объекта Control.Called after a child control is removed from the Controls collection of the Control object.

(Унаследовано от Control)
RemoveItems()

Удаляет все дочерние элементы управления в контейнере элемента или группы в элементе управления ListView.Deletes all child controls in an item or group container of the ListView control.

Render(HtmlTextWriter)

Отрисовывает содержимое элемента управления веб-сервера в клиентском браузере с использованием указанного объекта HtmlTextWriter.Renders the Web server control content to the client's browser by using the specified HtmlTextWriter object.

RenderBeginTag(HtmlTextWriter)

Выводит открывающий HTML-тег элемента управления в указанное средство записи.Renders the HTML opening tag of the control to the specified writer. Этот метод используется в основном разработчиками элементов управления.This method is used primarily by control developers.

(Унаследовано от WebControl)
RenderChildren(HtmlTextWriter)

Отправляет содержимое дочернего серверного элемента управления указанному объекту HtmlTextWriter, который записывает содержимое для преобразования на стороне клиента.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Унаследовано от Control)
RenderContents(HtmlTextWriter)

Выводит содержимое элемента управления в заданный модуль записи.Renders the contents of the control to the specified writer. Этот метод используется в основном разработчиками элементов управления.This method is used primarily by control developers.

(Унаследовано от WebControl)
RenderControl(HtmlTextWriter)

Выводит содержимое серверного элемента управления в указанный объект HtmlTextWriter и сохраняет сведения о трассировке элемента управления, если трассировка включена.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Унаследовано от Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Выводит серверный элемент управления в указанный объект HtmlTextWriter, используя указанный объект ControlAdapter.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Унаследовано от Control)
RenderEndTag(HtmlTextWriter)

Отображает закрывающий HTML-тег элемента управления в указанное средство записи.Renders the HTML closing tag of the control into the specified writer. Этот метод используется в основном разработчиками элементов управления.This method is used primarily by control developers.

(Унаследовано от WebControl)
ResolveAdapter()

Возвращает адаптер элемента управления, отвечающий за отрисовку определенного элемента управления.Gets the control adapter responsible for rendering the specified control.

(Унаследовано от Control)
ResolveClientUrl(String)

Возвращает URL-адрес, который может использоваться браузером.Gets a URL that can be used by the browser.

(Унаследовано от Control)
ResolveUrl(String)

Преобразует URL-адрес в адрес, доступный для клиента.Converts a URL into one that is usable on the requesting client.

(Унаследовано от Control)
SaveControlState()

Сохраняет состояние свойств элемента управления ListView, которое следует сохранить, даже если свойство EnableViewState имеет значение false.Saves the state of the properties in the ListView control that must be persisted, even when the EnableViewState property is set to false.

SaveViewState()

Сохраняет текущее состояние представления элемента управления ListView.Saves the current view state of the ListView control.

SelectItem(Int32)

Выбирает элемент, который находится в режиме правки в элементе управления ListView.Selects the item that is in edit mode in a ListView control.

SetDesignModeState(IDictionary)

Задает данные времени разработки для элемента управления.Sets design-time data for a control.

(Унаследовано от Control)
SetEditItem(Int32)

Переводит указанный элемент в режим правки в элементе управления ListView.Sets the specified item into edit mode in a ListView control.

SetPageProperties(Int32, Int32, Boolean)

Задает свойства страницы данных в элементе управления ListView.Sets the properties of a page of data in the ListView control.

SetRenderMethodDelegate(RenderMethod)

Назначает делегата обработчика событий для преобразования серверного элемента управления и его содержимого для просмотра в родительский элемент управления.Assigns an event handler delegate to render the server control and its content into its parent control.

(Унаследовано от Control)
SetTraceData(Object, Object)

Задает данные трассировки для трассировки данных отрисовки во время разработки, используя ключ данных трассировки и значение данных трассировки.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(Унаследовано от Control)
SetTraceData(Object, Object, Object)

Задает данные трассировки для трассировки данных отрисовки во время разработки, используя трассируемый объект, ключ данных трассировки и значение данных трассировки.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Унаследовано от Control)
Sort(String, SortDirection)

Сортирует элемент управления ListView в соответствии с указанным выражением сортировки и направлением.Sorts the ListView control, depending on the specified sort expression and direction.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)
TrackViewState()

Вызывает отслеживание изменений состояния представления элемента управления для сохранения в объекте StateBag элемента управления.Causes view-state changes to the control to be tracked so they can be stored in the control's StateBag object.

(Унаследовано от DataBoundControl)
UpdateItem(Int32, Boolean)

Обновляет запись по указанному индексу в источнике данных.Updates the record at the specified index in the data source.

ValidateDataSource(Object)

Проверяет, может ли элемент управления с привязкой к данным, привязываемый к объекту, работать с этим объектом.Verifies that the object a data-bound control binds to is one it can work with.

(Унаследовано от DataBoundControl)

События

CallingDataMethods

Возникает при вызове методов данных.Occurs when data methods are being called.

(Унаследовано от DataBoundControl)
CreatingModelDataSource

Происходит, когда объект ModelDataSource создается.Occurs when the ModelDataSource object is being created.

(Унаследовано от DataBoundControl)
DataBinding

Происходит при привязке серверного элемента управления к источнику данных.Occurs when the server control binds to a data source.

(Унаследовано от Control)
DataBound

Происходит после привязки серверного элемента управления к источнику данных.Occurs after the server control binds to a data source.

(Унаследовано от BaseDataBoundControl)
Disposed

Происходит при освобождении памяти, занятой серверным элементом управления, т.е. на последнем этапе жизненного цикла серверного элемента управления при запросе страницы ASP.NET.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(Унаследовано от Control)
Init

Происходит при инициализации серверного элемента управления, который находится на первом этапе его жизненного цикла.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Унаследовано от Control)
ItemCanceling

Происходит при запросе операции отмены, прежде чем элемент управления ListView отменяет операцию вставки или редактирования.Occurs when a cancel operation is requested, but before the ListView control cancels the insert or edit operation.

ItemCommand

Происходит при нажатии кнопки в элементе управления ListView.Occurs when a button in a ListView control is clicked.

ItemCreated

Происходит при создании элемента в элементе управления ListView.Occurs when an item is created in a ListView control.

ItemDataBound

Происходит, когда элемент данных привязан к данным в элементе управления ListView.Occurs when a data item is bound to data in a ListView control.

ItemDeleted

Происходит при запросе операции удаления, после того как элемент управления ListView удаляет элемент.Occurs when a delete operation is requested, after the ListView control deletes the item.

ItemDeleting

Происходит при запросе операции удаления, прежде чем элемент управления ListView удаляет элемент.Occurs when a delete operation is requested, but before the ListView control deletes the item.

ItemEditing

Происходит при запросе операции редактирования, прежде чем элемент ListView помещается в режим редактирования.Occurs when an edit operation is requested, but before the ListView item is put in edit mode.

ItemInserted

Происходит при запросе операции вставки, после того как элемент управления ListView вставил элемент в источник данных.Occurs when an insert operation is requested, after the ListView control has inserted the item in the data source.

ItemInserting

Происходит при запросе операции вставки, прежде чем элемент управления ListView выполнил вставку.Occurs when an insert operation is requested, but before the ListView control performs the insert.

ItemUpdated

Происходит при запросе операции обновления, после того как элемент управления ListView обновляет элемент.Occurs when an update operation is requested, after the ListView control updates the item.

ItemUpdating

Происходит при запросе операции обновления, прежде чем элемент управления ListView обновляет элемент.Occurs when an update operation is requested, but before the ListView control updates the item.

LayoutCreated

Происходит при создании шаблона LayoutTemplate в элементе управления ListView.Occurs when the LayoutTemplate template is created in a ListView control.

Load

Происходит при загрузке серверного элемента управления в объект Page.Occurs when the server control is loaded into the Page object.

(Унаследовано от Control)
PagePropertiesChanged

Происходит при изменении свойств страницы, после того как элемент управления ListView задает новые значения.Occurs when the page properties change, after the ListView control sets the new values.

PagePropertiesChanging

Происходит при изменении свойств страницы, прежде чем элемент управления ListView задает новые значения.Occurs when the page properties change, but before the ListView control sets the new values.

PreRender

Происходит после загрузки объекта Control, но перед отрисовкой.Occurs after the Control object is loaded but prior to rendering.

(Унаследовано от Control)
SelectedIndexChanged

Происходит при нажатии кнопки "Выбрать" в элементе, после того как элемент управления ListView обрабатывает операцию выделения.Occurs when an item's Select button is clicked, after the ListView control handles the select operation.

SelectedIndexChanging

Происходит при нажатии кнопки "Выбрать" в элементе, прежде чем элемент управления ListView обработал операцию выделения.Occurs when an item's Select button is clicked, but before the ListView control handles the select operation.

Sorted

Происходит при запросе операции сортировки, после того как элемент управления ListView обработал операцию сортировки.Occurs when a sort operation is requested, after the ListView control handles the sort operation.

Sorting

Происходит при запросе операции сортировки, прежде чем элемент управления ListView обработал операцию сортировки.Occurs when a sort operation is requested, but before the ListView control handles the sort operation.

Unload

Происходит при выгрузке серверного элемента управления из памяти.Occurs when the server control is unloaded from memory.

(Унаследовано от Control)

Явные реализации интерфейса

IAttributeAccessor.GetAttribute(String)

Возвращает атрибуту веб-элемента управления указанное имя.Gets an attribute of the Web control with the specified name.

(Унаследовано от WebControl)
IAttributeAccessor.SetAttribute(String, String)

Задает атрибуту веб-элемента управления указанное имя и значение.Sets an attribute of the Web control to the specified name and value.

(Унаследовано от WebControl)
IControlBuilderAccessor.ControlBuilder

Описание этого члена см. в разделе ControlBuilder.For a description of this member, see ControlBuilder.

(Унаследовано от Control)
IControlDesignerAccessor.GetDesignModeState()

Описание этого члена см. в разделе GetDesignModeState().For a description of this member, see GetDesignModeState().

(Унаследовано от Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Описание этого члена см. в разделе SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

(Унаследовано от Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Описание этого члена см. в разделе SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

(Унаследовано от Control)
IControlDesignerAccessor.UserData

Описание этого члена см. в разделе UserData.For a description of this member, see UserData.

(Унаследовано от Control)
IDataBindingsAccessor.DataBindings

Описание этого члена см. в разделе DataBindings.For a description of this member, see DataBindings.

(Унаследовано от Control)
IDataBindingsAccessor.HasDataBindings

Описание этого члена см. в разделе HasDataBindings.For a description of this member, see HasDataBindings.

(Унаследовано от Control)
IDataBoundControl.DataKeyNames

Получает или задает массив, содержащий имена полей первичных ключей для элементов, отображенных в элементе управления с привязкой к данным.Gets or sets an array that contains the names of the primary-key fields of the items that are displayed in a data-bound control.

IDataBoundControl.DataMember

Получает или задает имя списка данных, к которому выполняется привязка элемента управления с привязкой к данным в случае наличия в источнике данных нескольких отдельных списков элементов данных.Gets or sets the name of the list of data that the data-bound control binds to when the data source contains more than one distinct list of data items.

IDataBoundControl.DataSource

Получает или задает объект, из которого элемент управления с привязкой к данным извлекает свой список элементов данных.Gets or sets the object from which a data-bound control retrieves its list of data items.

IDataBoundControl.DataSourceID

Получает или задает идентификатор элемента управления источником данных, из которого элемент управления с привязкой к данным извлекает список элементов данных.Gets or sets the ID of the data source control from which a data-bound control retrieves its list of data items.

IDataBoundControl.DataSourceObject

Возвращает объект, реализующий интерфейс IDataSource, который предоставляет доступ к содержимому данных объекта.Gets an object that implements the IDataSource interface, which provides access to the object's data content.

IDataBoundListControl.ClientIDRowSuffix

Получает имя поля данных, значение которого используется как уникальный идентификатор каждой строки данных в элементе управления ListView, если свойство ClientIDMode имеет значение Predictable.Gets the name of the data field whose value is used to uniquely identify each data row of a ListView control when the ClientIDMode property is set to Predictable.

IDataBoundListControl.DataKeys

Получает коллекцию значений ключей данных, представляющих каждую строку в элементе управления с привязкой к данным.Gets a collection of data-key values that represent each row in a data-bound control.

IDataBoundListControl.EnablePersistedSelection

Получает или задает значение, определяющее, сохраняется ли выделенная строка при использовании пользовательской страницей данных элемента управления с привязкой к данным.Gets or sets the value that specifies whether a selected row persists when a user pages through data in a data-bound control.

IDataBoundListControl.SelectedDataKey

Получает объект ключа данных, содержащий значение ключа данных для выбранной строки в элементе управления с привязкой к данным.Gets the data-key object that contains the data-key value for the selected row in a data-bound control.

IDataBoundListControl.SelectedIndex

Получает или задает индекс выбранной строки в элементе управления с привязкой к данным.Gets or sets the index of the selected row in a data-bound control.

IDataKeysControl.ClientIDRowSuffixDataKeys

Получает коллекцию значений данных, которые используются для однозначной идентификации каждого экземпляра элемента управления с привязкой к данным при формировании платформой ASP.NET значения ClientID.Gets a collection of the data values that are used to uniquely identify each instance of a data-bound control when ASP.NET generates the ClientID value.

IExpressionsAccessor.Expressions

Описание этого члена см. в разделе Expressions.For a description of this member, see Expressions.

(Унаследовано от Control)
IExpressionsAccessor.HasExpressions

Описание этого члена см. в разделе HasExpressions.For a description of this member, see HasExpressions.

(Унаследовано от Control)
IPageableItemContainer.MaximumRows

Описание этого члена см. в разделе MaximumRows.For a description of this member, see MaximumRows.

IPageableItemContainer.SetPageProperties(Int32, Int32, Boolean)

Описание этого члена см. в разделе SetPageProperties(Int32, Int32, Boolean).For a description of this member, see SetPageProperties(Int32, Int32, Boolean).

IPageableItemContainer.StartRowIndex

Описание этого члена см. в разделе StartRowIndex.For a description of this member, see StartRowIndex.

IPageableItemContainer.TotalRowCountAvailable

Описание этого члена см. в разделе TotalRowCountAvailable.For a description of this member, see TotalRowCountAvailable.

IParserAccessor.AddParsedSubObject(Object)

Описание этого члена см. в разделе AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

(Унаследовано от Control)
IPersistedSelector.DataKey

Возвращает или задает значение ключа данных выбранной записи в элементе управления с привязкой к данным.Gets or sets the data-key value for the selected record in a data-bound control.

IWizardSideBarListControl.Items

Методы расширения

EnablePersistedSelection(BaseDataBoundControl)

Включает возможность сохранения в элементах управления данными, поддерживающих выделение и разбиение по страницам.Enables selection to be persisted in data controls that support selection and paging.

FindDataSourceControl(Control)

Возвращает источник данных, связанный с элементом управления данными, для заданного элемента управления.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

Возвращает шаблон поля для заданного столбца в контейнере именования заданного элемента управления.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

Возвращает объект метатаблицы для контейнерного элемента управления данными.Returns the metatable object for the containing data control.

GetDefaultValues(INamingContainer)

Получает коллекцию значений по умолчанию для заданного элемента управления данными.Gets the collection of the default values for the specified data control.

GetMetaTable(INamingContainer)

Получает метаданные таблицы для заданного элемента управления данными.Gets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable)

Задает метаданные таблицы для заданного элемента управления данными.Sets the table metadata for the specified data control.

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

Задает метаданные таблицы и преобразование значений по умолчанию для заданного элемента управления данными.Sets the table metadata and default value mapping for the specified data control.

SetMetaTable(INamingContainer, MetaTable, Object)

Задает метаданные таблицы и преобразование значений по умолчанию для заданного элемента управления данными.Sets the table metadata and default value mapping for the specified data control.

TryGetMetaTable(INamingContainer, MetaTable)

Определяет, доступны ли метаданные таблицы.Determines whether table metadata is available.

EnableDynamicData(INamingContainer, Type)

Включает поведение платформы динамических данных для указанного элемента управления данными.Enables Dynamic Data behavior for the specified data control.

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

Включает поведение платформы динамических данных для указанного элемента управления данными.Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, Object)

Включает поведение платформы динамических данных для указанного элемента управления данными.Enables Dynamic Data behavior for the specified data control.

Применяется к

Дополнительно