DataList Класс

Определение

Пространство имен:: System.Web.UI.WebControls

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Элемент управления списком привязанных к данным данных, в котором отображаются элементы с помощью шаблонов.

public ref class DataList : System::Web::UI::WebControls::BaseDataList, System::Web::UI::INamingContainer, System::Web::UI::WebControls::IRepeatInfoUser

public class DataList : System.Web.UI.WebControls.BaseDataList, System.Web.UI.INamingContainer, System.Web.UI.WebControls.IRepeatInfoUser

[System.Web.UI.ControlValueProperty("SelectedValue")]
public class DataList : System.Web.UI.WebControls.BaseDataList, System.Web.UI.INamingContainer, System.Web.UI.WebControls.IRepeatInfoUser

type DataList = class
    inherit BaseDataList
    interface INamingContainer
    interface IRepeatInfoUser

[<System.Web.UI.ControlValueProperty("SelectedValue")>]
type DataList = class
    inherit BaseDataList
    interface INamingContainer
    interface IRepeatInfoUser

Public Class DataList
Inherits BaseDataList
Implements INamingContainer, IRepeatInfoUser

Наследование: Object

Control

WebControl

BaseDataList
DataList

Атрибуты: ControlValuePropertyAttribute

Реализации: INamingContainer IRepeatInfoUser

Примеры

В следующем примере кода показано, как использовать DataList элемент управления для отображения списка элементов из источника данных.

Замечание

В следующем примере кода используется модель кода с одним файлом и может не работать правильно, если она копируется непосредственно в файл программной части. Этот пример кода должен быть скопирован в пустой текстовый файл с расширением .aspx. Дополнительные сведения о модели кода веб-форм см. в разделе ASP.NET модель кода веб-форм.


<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!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" >
   <script runat="server">
 
      ICollection CreateDataSource() 
      {
      
         // Create sample data for the DataList control.
         DataTable dt = new DataTable();
         DataRow dr;
 
         // Define the columns of the table.
         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue", typeof(String)));
         dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));
         dt.Columns.Add(new DataColumn("ImageValue", typeof(String)));
 
         // Populate the table with sample values.
         for (int i = 0; i < 9; i++) 
         {
            dr = dt.NewRow();
 
            dr[0] = i;
            dr[1] = "Description for item " + i.ToString();
            dr[2] = 1.23 * (i + 1);
            dr[3] = "Image" + i.ToString() + ".jpg";
 
            dt.Rows.Add(dr);
         }
 
         DataView dv = new DataView(dt);
         return dv;
      }
 
 
      void Page_Load(Object sender, EventArgs e) 
      {

         // Load sample data only once, when the page is first loaded.
         if (!IsPostBack) 
         {
            ItemsList.DataSource = CreateDataSource();
            ItemsList.DataBind();
         }

      }
 
   </script>
 
<head runat="server">
    <title>DataList Example</title>
</head>
<body>
 
   <form id="form1" runat="server">

      <h3>DataList Example</h3>
 
      <asp:DataList id="ItemsList"
           BorderColor="black"
           CellPadding="5"
           CellSpacing="5"
           RepeatDirection="Vertical"
           RepeatLayout="Table"
           RepeatColumns="3"
           runat="server">

         <HeaderStyle BackColor="#aaaadd">
         </HeaderStyle>

         <AlternatingItemStyle BackColor="Gainsboro">
         </AlternatingItemStyle>

         <HeaderTemplate>

            List of items

         </HeaderTemplate>
               
         <ItemTemplate>

            Description: <br />
            <%# DataBinder.Eval(Container.DataItem, "StringValue") %>

            <br />

            Price: <%# DataBinder.Eval(Container.DataItem, "CurrencyValue", "{0:c}") %>

            <br />

            <asp:Image id="ProductImage" AlternateText="Product picture" 
                 ImageUrl='<%# DataBinder.Eval(Container.DataItem, "ImageValue") %>'
                 runat="server"/>

         </ItemTemplate>
 
      </asp:DataList>
 
   </form>
 
</body>
</html>


<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!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" >
   <script runat="server">
 
      Function CreateDataSource() As ICollection 
      
         ' Create sample data for the DataList control.
         Dim dt As DataTable = New DataTable()
         dim dr As DataRow
 
         ' Define the columns of the table.
         dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
         dt.Columns.Add(New DataColumn("StringValue", GetType(String)))
         dt.Columns.Add(New DataColumn("CurrencyValue", GetType(Double)))
         dt.Columns.Add(New DataColumn("ImageValue", GetType(String)))
 
         ' Populate the table with sample values.
         Dim i As Integer

         For i = 0 To 8 

            dr = dt.NewRow()
 
            dr(0) = i
            dr(1) = "Description for item " & i.ToString()
            dr(2) = 1.23 * (i + 1)
            dr(3) = "Image" & i.ToString() & ".jpg"
 
            dt.Rows.Add(dr)

         Next i
 
         Dim dv As DataView = New DataView(dt)
         Return dv

      End Function
 
      Sub Page_Load(sender As Object, e As EventArgs) 

         ' Load sample data only once, when the page is first loaded.
         If Not IsPostBack Then 
     
            ItemsList.DataSource = CreateDataSource()
            ItemsList.DataBind()
         
         End If

      End Sub
 
   </script>
 
<head runat="server">
    <title>DataList Example</title>
</head>
<body>
 
   <form id="form1" runat="server">

      <h3>DataList Example</h3>
 
      <asp:DataList id="ItemsList"
           BorderColor="black"
           CellPadding="5"
           CellSpacing="5"
           RepeatDirection="Vertical"
           RepeatLayout="Table"
           RepeatColumns="3"
           runat="server">

         <HeaderStyle BackColor="#aaaadd">
         </HeaderStyle>

         <AlternatingItemStyle BackColor="Gainsboro">
         </AlternatingItemStyle>

         <HeaderTemplate>

            List of items

         </HeaderTemplate>
               
         <ItemTemplate>

            Description: <br />
            <%# DataBinder.Eval(Container.DataItem, "StringValue") %>

            <br />

            Price: <%# DataBinder.Eval(Container.DataItem, "CurrencyValue", "{0:c}") %>

            <br />

            <asp:Image id="ProductImage" AlternateText="Product picture" 
                 ImageUrl='<%# DataBinder.Eval(Container.DataItem, "ImageValue") %>'
                 runat="server"/>

         </ItemTemplate>
 
      </asp:DataList>
 
   </form>
 
</body>
</html>

Имя шаблона	Описание
AlternatingItemTemplate	Если определено, предоставляет содержимое и макет для чередующихся элементов в объекте DataList. Если не определено, `ItemTemplate` используется.
EditItemTemplate	Если определено, предоставляет содержимое и макет для элемента, который в данный момент редактируется в элементе DataList. Если не определено, `ItemTemplate` используется.
FooterTemplate	Если определено, предоставляет содержимое и макет для нижнего DataListколонтитула. Если это не определено, раздел нижнего колонтитула не будет отображаться.
HeaderTemplate	Если определено, предоставляет содержимое и макет для раздела заголовка DataList. Если это не определено, раздел заголовка не будет отображаться.
ItemTemplate	Обязательный шаблон, предоставляющий содержимое и макет для элементов в элементе DataList.
SelectedItemTemplate	Если определено, предоставляет содержимое и макет для выбранного в данный момент элемента DataList. Если не определено, ItemTemplate используется.
SeparatorTemplate	Если определено, предоставляет содержимое и макет для разделителя между элементами в элементе DataList. Если это не определено, разделитель не будет отображаться.

По крайней мере, ItemTemplate необходимо определить элементы в элементе DataList управления. Дополнительные шаблоны можно использовать для предоставления пользовательского DataList внешнего вида элемента управления.

Настройка внешнего вида элемента управления DataList

Внешний DataList вид элемента управления можно настроить, задав свойства стиля для различных частей элемента управления. В следующей таблице перечислены различные свойства стиля.

Свойство Style	Описание
AlternatingItemStyle	Задает стиль для чередования элементов в элементе DataList управления.
EditItemStyle	Задает стиль редактируемого элемента в элементе DataList управления.
FooterStyle	Задает стиль нижнего колонтитула в элементе DataList управления.
HeaderStyle	Задает стиль заголовка в элементе DataList управления.
ItemStyle	Задает стиль элементов в элементе DataList управления.
SelectedItemStyle	Задает стиль выбранного элемента в элементе DataList управления.
SeparatorStyle	Задает стиль разделителя между элементами в элементе DataList управления.

Вы также можете отображать или скрывать различные части элемента управления. В следующей таблице перечислены свойства, управляющие отображением или скрытием частей.

Недвижимость	Описание
ShowFooter	Отображает или скрывает нижний колонтитул DataList элемента управления.
ShowHeader	Отображает или скрывает раздел заголовка DataList элемента управления.

Направление отображения и макет

Направление DataList отображения элемента управления может быть вертикальным или горизонтальным. RepeatDirection Задайте свойство, чтобы указать направление отображения.

Макет DataList элемента управления управляется свойством RepeatLayout . При задании этого свойства RepeatLayout.Table будет отображаться DataList в формате таблицы, в то время как RepeatLayout.Flow отображается DataList без структуры таблицы.

Безопасность

Элемент DataList управления может содержать элементы управления, позволяющие пользователям вводить сведения.

Предостережение

Этот элемент управления можно использовать для отображения входных данных пользователей, которые могут включать вредоносный скрипт клиента. Проверьте все сведения, отправляемые клиентом для исполняемого скрипта, инструкций SQL или другого кода перед отображением в приложении. Перед отображением входного текста в элементе управления можно использовать элементы управления проверкой. ASP.NET предоставляет функцию проверки входных запросов для блокировки скрипта и HTML в входных данных пользователя.

Дополнительные сведения о безопасности см. в статье "Защита стандартных элементов управления", "Практическое руководство. Защита от эксплойтов скриптов в веб-приложении путем применения кодировки HTML к строкам" и проверки входных данных пользователей в ASP.NET веб-страницах.

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

<asp:DataList
    AccessKey="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    Caption="string"
    CaptionAlign="NotSet|Top|Bottom|Left|Right"
    CellPadding="integer"
    CellSpacing="integer"
    CssClass="string"
    DataKeyField="string"
    DataMember="string"
    DataSource="string"
    DataSourceID="string"
    EditItemIndex="integer"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    ExtractTemplateRows="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    GridLines="None|Horizontal|Vertical|Both"
    Height="size"
    HorizontalAlign="NotSet|Left|Center|Right|Justify"
    ID="string"
    OnCancelCommand="CancelCommand event handler"
    OnDataBinding="DataBinding event handler"
    OnDeleteCommand="DeleteCommand event handler"
    OnDisposed="Disposed event handler"
    OnEditCommand="EditCommand event handler"
    OnInit="Init event handler"
    OnItemCommand="ItemCommand event handler"
    OnItemCreated="ItemCreated event handler"
    OnItemDataBound="ItemDataBound event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnSelectedIndexChanged="SelectedIndexChanged event handler"
    OnUnload="Unload event handler"
    OnUpdateCommand="UpdateCommand event handler"
    RepeatColumns="integer"
    RepeatDirection="Horizontal|Vertical"
    RepeatLayout="Table|Flow"
    runat="server"
    SelectedIndex="integer"
    ShowFooter="True|False"
    ShowHeader="True|False"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    ToolTip="string"
    UseAccessibleHeader="True|False"
    Visible="True|False"
    Width="size"
>
        <AlternatingItemStyle />
        <AlternatingItemTemplate>
            <!-- child controls -->
        </AlternatingItemTemplate>
        <EditItemStyle />
        <EditItemTemplate>
            <!-- child controls -->
        </EditItemTemplate>
        <FooterStyle />
        <FooterTemplate>
            <!-- child controls -->
        </FooterTemplate>
        <HeaderStyle />
        <HeaderTemplate>
            <!-- child controls -->
        </HeaderTemplate>
        <ItemStyle />
        <ItemTemplate>
            <!-- child controls -->
        </ItemTemplate>
        <SelectedItemStyle />
        <SelectedItemTemplate>
            <!-- child controls -->
        </SelectedItemTemplate>
        <SeparatorStyle />
        <SeparatorTemplate>
            <!-- child controls -->
        </SeparatorTemplate>
</asp:DataList>

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

Имя	Описание
DataList()	Инициализирует новый экземпляр класса DataList.

Поля

Имя	Описание
CancelCommandName	`Cancel` Представляет имя команды. Это поле доступно только для чтения.
DeleteCommandName	`Delete` Представляет имя команды. Это поле доступно только для чтения.
EditCommandName	`Edit` Представляет имя команды. Это поле доступно только для чтения.
SelectCommandName	`Select` Представляет имя команды. Это поле доступно только для чтения.
UpdateCommandName	`Update` Представляет имя команды. Это поле доступно только для чтения.

Свойства

Имя	Описание
AccessKey	Возвращает или задает ключ доступа, позволяющий быстро перейти к элементу управления веб-сервера. (Унаследовано от WebControl)
Adapter	Возвращает адаптер, зависящий от браузера, для элемента управления. (Унаследовано от Control)
AlternatingItemStyle	Возвращает свойства стиля для чередования элементов в элементе DataList управления.
AlternatingItemTemplate	Возвращает или задает шаблон для чередования элементов в элементе DataList.
AppRelativeTemplateSourceDirectory	Возвращает или задает относительный к приложению виртуальный каталог Page объекта или UserControl объекта, содержащего этот элемент управления. (Унаследовано от Control)
Attributes	Возвращает коллекцию произвольных атрибутов (только для отрисовки), которые не соответствуют свойствам элемента управления. (Унаследовано от WebControl)
BackColor	Возвращает или задает цвет фона элемента управления веб-сервера. (Унаследовано от WebControl)
BindingContainer	Возвращает элемент управления, содержащий привязку данных этого элемента управления. (Унаследовано от Control)
BorderColor	Возвращает или задает цвет границы веб-элемента управления. (Унаследовано от WebControl)
BorderStyle	Возвращает или задает стиль границы элемента управления веб-сервера. (Унаследовано от WebControl)
BorderWidth	Возвращает или задает ширину границы элемента управления веб-сервера. (Унаследовано от WebControl)
Caption	Получает или задает текст для отрисовки в элементе заголовка HTML в элементе управления. Это свойство предоставляется, чтобы сделать элемент управления более доступным для пользователей вспомогательных технологических устройств. (Унаследовано от BaseDataList)
CaptionAlign	Возвращает или задает горизонтальное или вертикальное положение элемента заголовка HTML в элементе управления. Это свойство предоставляется, чтобы сделать элемент управления более доступным для пользователей вспомогательных технологических устройств. (Унаследовано от BaseDataList)
CellPadding	Возвращает или задает объем пространства между содержимым ячейки и границей ячейки. (Унаследовано от BaseDataList)
CellSpacing	Возвращает или задает объем пространства между ячейками. (Унаследовано от BaseDataList)
ChildControlsCreated	Возвращает значение, указывающее, были ли созданы дочерние элементы управления сервера. (Унаследовано от Control)
ClientID	Возвращает идентификатор элемента управления для разметки HTML, созданной ASP.NET. (Унаследовано от Control)
ClientIDMode	Возвращает или задает алгоритм, используемый для создания значения ClientID свойства. (Унаследовано от Control)
ClientIDSeparator	Возвращает значение символа, представляющее символ разделителя, используемый в свойстве ClientID . (Унаследовано от Control)
Context	HttpContext Возвращает объект, связанный с серверным элементом управления для текущего веб-запроса. (Унаследовано от Control)
Controls	ControlCollection Возвращает объект, содержащий коллекцию дочерних элементов управления в элементе управления перечислением данных. (Унаследовано от BaseDataList)
ControlStyle	Возвращает стиль элемента управления веб-сервера. Это свойство используется главным образом разработчиками элементов управления. (Унаследовано от WebControl)
ControlStyleCreated	Возвращает значение, указывающее, был ли Style объект создан для ControlStyle свойства. Это свойство в основном используется разработчиками элементов управления. (Унаследовано от WebControl)
CssClass	Возвращает или задает класс каскадной таблицы стилей (CSS), отображаемый элементом управления веб-сервера на клиенте. (Унаследовано от WebControl)
DataItemContainer	Возвращает ссылку на контейнер именования, если контейнер именования реализует IDataItemContainer. (Унаследовано от Control)
DataKeyField	Возвращает или задает поле ключа в источнике данных, указанном свойством DataSource . (Унаследовано от BaseDataList)
DataKeys	DataKeyCollection Возвращает объект, в котором хранятся ключевые значения каждой записи в элементе управления перечислением данных. (Унаследовано от BaseDataList)
DataKeysArray	ArrayList Возвращает объект, содержащий ключевые значения каждой записи в элементе управления перечислением данных. (Унаследовано от BaseDataList)
DataKeysContainer	Возвращает ссылку на контейнер именования, если контейнер именования реализует IDataKeysControl. (Унаследовано от Control)
DataMember	Возвращает или задает определенный элемент данных в многомемерном источнике данных для привязки к элементу управления перечислением данных. (Унаследовано от BaseDataList)
DataSource	Возвращает или задает источник, содержащий список значений, используемых для заполнения элементов в элементе управления. (Унаследовано от BaseDataList)
DataSourceID	Возвращает или задает ID свойство элемента управления источниками данных, которое элемент управления перечисления данных должен использовать для получения своего источника данных. (Унаследовано от BaseDataList)
DesignMode	Возвращает значение, указывающее, используется ли элемент управления на поверхности конструктора. (Унаследовано от Control)
EditItemIndex	Возвращает или задает номер индекса выбранного элемента в элементе DataList управления для изменения.
EditItemStyle	Возвращает свойства стиля элемента, выбранного для редактирования в элементе DataList управления.
EditItemTemplate	Возвращает или задает шаблон элемента, выбранного для редактирования в элементе DataList управления.
Enabled	Возвращает или задает значение, указывающее, включен ли элемент управления веб-сервера. (Унаследовано от WebControl)
EnableTheming	Возвращает или задает значение, указывающее, применяются ли темы к этому элементу управления. (Унаследовано от WebControl)
EnableViewState	Возвращает или задает значение, указывающее, сохраняет ли серверный элемент управления состояние представления и состояние представления всех дочерних элементов управления, содержащихся в нем, для запрашивающего клиента. (Унаследовано от Control)
Events	Возвращает список делегатов обработчика событий для элемента управления. Это свойство доступно только для чтения. (Унаследовано от Control)
ExtractTemplateRows	Возвращает или задает значение, указывающее, извлекаются ли и отображаются строки Table элемента управления, определенные в каждом шаблоне DataList элемента управления.
Font	Возвращает свойства шрифта, связанные с элементом управления веб-сервера. (Унаследовано от WebControl)
FooterStyle	Возвращает свойства стиля для нижнего DataList колонтитула элемента управления.
FooterTemplate	Возвращает или задает шаблон для нижнего DataList колонтитула элемента управления.
ForeColor	Возвращает или задает цвет переднего плана (обычно цвет текста) элемента управления веб-сервера. (Унаследовано от WebControl)
GridLines	Возвращает или задает стиль линии сетки для DataList элемента управления, если RepeatLayout для свойства задано значение `RepeatLayout.Table`.
HasAttributes	Возвращает значение, указывающее, имеет ли элемент управления набор атрибутов. (Унаследовано от WebControl)
HasChildViewState	Получает значение, указывающее, имеют ли дочерние элементы управления текущего элемента управления серверным элементом управления какие-либо сохраненные параметры состояния представления. (Унаследовано от Control)
HeaderStyle	Возвращает свойства стиля для раздела заголовка DataList элемента управления.
HeaderTemplate	Возвращает или задает шаблон для раздела заголовка DataList элемента управления.
Height	Возвращает или задает высоту элемента управления веб-сервера. (Унаследовано от WebControl)
HorizontalAlign	Возвращает или задает горизонтальное выравнивание элемента управления перечислением данных в контейнере. (Унаследовано от BaseDataList)
ID	Возвращает или задает программный идентификатор, назначенный элементу управления сервером. (Унаследовано от Control)
IdSeparator	Возвращает символ, используемый для разделения идентификаторов элемента управления. (Унаследовано от Control)
Initialized	Возвращает значение, указывающее, был ли элемент управления инициализирован. (Унаследовано от BaseDataList)
IsBoundUsingDataSourceID	Возвращает значение, указывающее, задано ли DataSourceID свойство. (Унаследовано от BaseDataList)
IsChildControlStateCleared	Возвращает значение, указывающее, имеют ли элементы управления, содержащиеся в этом элементе управления, состояние элемента управления. (Унаследовано от Control)
IsEnabled	Возвращает значение, указывающее, включен ли элемент управления. (Унаследовано от WebControl)
IsTrackingViewState	Возвращает значение, указывающее, сохраняется ли серверная система управления изменениями в состоянии представления. (Унаследовано от Control)
IsViewStateEnabled	Возвращает значение, указывающее, включено ли состояние представления для этого элемента управления. (Унаследовано от Control)
Items	Возвращает коллекцию DataListItem объектов, представляющих отдельные элементы в элементе управления.
ItemStyle	Возвращает свойства стиля для элементов в элементе DataList управления.
ItemTemplate	Возвращает или задает шаблон для элементов в элементе DataList управления.
LoadViewStateByID	Возвращает значение, указывающее, участвует ли элемент управления в загрузке состояния ID представления вместо индекса. (Унаследовано от Control)
NamingContainer	Возвращает ссылку на контейнер именования серверного элемента управления, который создает уникальное пространство имен для различения между элементами управления сервера с ID одинаковым значением свойства. (Унаследовано от Control)
Page	Возвращает ссылку на Page экземпляр, содержащий серверный элемент управления. (Унаследовано от Control)
Parent	Возвращает ссылку на родительский элемент управления сервера в иерархии элементов управления страницами. (Унаследовано от Control)
RenderingCompatibility	Возвращает значение, указывающее версию ASP.NET, с которым будет совместим отрисованный HTML. (Унаследовано от Control)
RepeatColumns	Возвращает или задает количество столбцов, отображаемых в элементе DataList управления.
RepeatDirection	Возвращает или задает, отображается ли DataList элемент управления вертикально или горизонтально.
RepeatLayout	Возвращает или задает, отображается ли элемент управления в макете таблицы или потока.
RequiresDataBinding	Возвращает или задает значение, указывающее, требуется ли элементу управления перечисления данных привязку к указанному источнику данных. (Унаследовано от BaseDataList)
SelectArguments	DataSourceSelectArguments Возвращает объект, который элемент управления, привязанный к данным, используется при получении данных из элемента управления источниками данных. (Унаследовано от BaseDataList)
SelectedIndex	Возвращает или задает индекс выбранного элемента в элементе DataList управления.
SelectedItem	Возвращает выбранный элемент в элементе DataList управления.
SelectedItemStyle	Возвращает свойства стиля для выбранного элемента в элементе DataList управления.
SelectedItemTemplate	Возвращает или задает шаблон для выбранного элемента в элементе DataList управления.
SelectedValue	Возвращает значение поля ключа для выбранного элемента списка данных.
SeparatorStyle	Возвращает свойства стиля разделителя между каждым элементом в элементе DataList управления.
SeparatorTemplate	Возвращает или задает шаблон для разделителя элементов DataList элемента управления.
ShowFooter	Возвращает или задает значение, указывающее, отображается ли нижний колонтитул в элементе DataList управления.
ShowHeader	Возвращает или задает значение, указывающее, отображается ли раздел заголовка в элементе DataList управления.
Site	Получает сведения о контейнере, на котором размещается текущий элемент управления при отрисовки на поверхности конструктора. (Унаследовано от Control)
SkinID	Возвращает или задает кожу, применяемую к элементу управления. (Унаследовано от WebControl)
Style	Возвращает коллекцию текстовых атрибутов, которые будут отображаться как атрибут стиля во внешнем теге элемента управления веб-сервера. (Унаследовано от WebControl)
SupportsDisabledAttribute	Возвращает значение, указывающее, должен ли элемент управления задать `disabled` атрибут отрисованного HTML-элемента значение "отключено" при наличии `false`свойства элемента управленияIsEnabled. (Унаследовано от BaseDataList)
TabIndex	Возвращает или задает индекс табуляции элемента управления веб-сервера. (Унаследовано от WebControl)
TagKey	Возвращает HTML-тег, используемый для отрисовки DataList элемента управления.
TagKey	Возвращает значение, соответствующее HtmlTextWriterTag этому элементу управления веб-сервера. Это свойство используется главным образом разработчиками элементов управления. (Унаследовано от WebControl)
TagName	Возвращает имя тега элемента управления. Это свойство используется главным образом разработчиками элементов управления. (Унаследовано от WebControl)
TemplateControl	Возвращает или задает ссылку на шаблон, содержащий этот элемент управления. (Унаследовано от Control)
TemplateSourceDirectory	Возвращает виртуальный Page каталог или UserControl содержащий текущий серверный элемент управления. (Унаследовано от Control)
ToolTip	Возвращает или задает текст, отображаемый при наведении указателя мыши на элемент управления веб-сервера. (Унаследовано от WebControl)
UniqueID	Возвращает уникальный иерархический идентификатор для элемента управления сервером. (Унаследовано от Control)
UseAccessibleHeader	Возвращает или задает значение, указывающее, отображает ли элемент управления перечислением данных его заголовок в доступном формате. Это свойство предоставляется, чтобы сделать элемент управления более доступным для пользователей вспомогательных технологических устройств. (Унаследовано от BaseDataList)
ValidateRequestMode	Возвращает или задает значение, указывающее, проверяет ли элемент управления входные данные клиента из браузера для потенциально опасных значений. (Унаследовано от Control)
ViewState	Получает словарь сведений о состоянии, позволяющий сохранять и восстанавливать состояние представления серверного элемента управления в нескольких запросах на одну и ту же страницу. (Унаследовано от Control)
ViewStateIgnoresCase	Возвращает значение, указывающее, является ли StateBag объект нечувствительным к регистру. (Унаследовано от Control)
ViewStateMode	Возвращает или задает режим состояния представления этого элемента управления. (Унаследовано от Control)
Visible	Возвращает или задает значение, указывающее, отображается ли серверный элемент управления в виде пользовательского интерфейса на странице. (Унаследовано от Control)
Width	Возвращает или задает ширину элемента управления веб-сервера. (Унаследовано от WebControl)

Методы

Имя	Описание
AddAttributesToRender(HtmlTextWriter)	Добавляет атрибуты и стили HTML, которые должны быть отрисованы в указанные HtmlTextWriterTag. Этот метод используется главным образом разработчиками элементов управления. (Унаследовано от WebControl)
AddedControl(Control, Int32)	Вызывается после добавления дочернего Control элемента управления в Controls коллекцию объекта. (Унаследовано от Control)
AddParsedSubObject(Object)	Уведомляет серверный элемент управления о том, что элемент ( XML или HTML) был проанализирован и добавляет элемент в коллекцию серверного элемента управления ControlCollection . (Унаследовано от BaseDataList)
ApplyStyle(Style)	Копирует все небланковые элементы указанного стиля в веб-элемент управления, перезаписыв все существующие элементы стиля элемента управления. Этот метод в основном используется разработчиками элементов управления. (Унаследовано от WebControl)
ApplyStyleSheetSkin(Page)	Применяет свойства стиля, определенные в таблице стилей страницы, к элементу управления. (Унаследовано от Control)
BeginRenderTracing(TextWriter, Object)	Начинает трассировку данных отрисовки во время разработки. (Унаследовано от Control)
BuildProfileTree(String, Boolean)	Собирает сведения о серверном элементе управления и передает его Trace свойству, которое будет отображаться при включении трассировки для страницы. (Унаследовано от Control)
ClearCachedClientID()	Задает кэшированное ClientID значение `null`. (Унаследовано от Control)
ClearChildControlState()	Удаляет сведения о состоянии элемента управления для дочерних элементов управления сервера. (Унаследовано от Control)
ClearChildState()	Удаляет сведения о состоянии представления и состояния элемента управления для всех дочерних элементов управления сервера. (Унаследовано от Control)
ClearChildViewState()	Удаляет сведения о состоянии представления для всех дочерних элементов управления сервера. (Унаследовано от Control)
ClearEffectiveClientIDMode()	ClientIDMode Задает свойство текущего экземпляра элемента управления и всех дочерних элементов управленияInherit. (Унаследовано от Control)
CopyBaseAttributes(WebControl)	Копирует свойства, не инкапсулированные Style объектом из указанного элемента управления веб-сервера, в элемент управления веб-сервера, из который вызывается этот метод. Этот метод используется главным образом разработчиками элементов управления. (Унаследовано от WebControl)
CreateChildControls()	Создает дочерний элемент управления с помощью состояния представления. (Унаследовано от BaseDataList)
CreateControlCollection()	Создает новый ControlCollection объект для хранения дочерних элементов управления (как литерала, так и сервера) элемента управления сервером. (Унаследовано от Control)
CreateControlHierarchy(Boolean)	Создает иерархию элементов управления, которая используется для отрисовки элемента управления списком данных с указанным источником данных или без нее.
CreateControlStyle()	Создает объект стиля по умолчанию, который используется внутри DataList элемента управления для реализации всех свойств, связанных со стилем.
CreateDataSourceSelectArguments()	Создает объект по умолчанию DataSourceSelectArguments , используемый элементом управления с привязкой к данным, если аргументы не указаны. (Унаследовано от BaseDataList)
CreateItem(Int32, ListItemType)	Создает объект DataListItem.
DataBind()	Привязывает элемент управления и все дочерние элементы управления к указанному источнику данных. (Унаследовано от BaseDataList)
DataBind(Boolean)	Привязывает источник данных к вызываемой серверной системе управления и всем его дочерним элементам управления с возможностью вызвать DataBinding событие. (Унаследовано от Control)
DataBindChildren()	Привязывает источник данных к дочерним элементам управления сервера. (Унаследовано от Control)
Dispose()	Позволяет элементу управления сервера выполнять окончательную очистку перед освобождением из памяти. (Унаследовано от Control)
EndRenderTracing(TextWriter, Object)	Завершает трассировку времени разработки данных отрисовки. (Унаследовано от Control)
EnsureChildControls()	Определяет, содержит ли серверный элемент управления дочерние элементы управления. Если это не так, он создает дочерние элементы управления. (Унаследовано от Control)
EnsureDataBound()	Проверяет, требуется ли элемент управления перечислением данных привязка данных и указан допустимый элемент управления источником данных перед вызовом DataBind() метода. (Унаследовано от BaseDataList)
EnsureID()	Создает идентификатор для элементов управления, которым не назначен идентификатор. (Унаследовано от Control)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
FindControl(String, Int32)	Выполняет поиск текущего контейнера именования для элемента управления сервером с указанным `id` и целым числом, указанным в `pathOffset` параметре, который помогает в поиске. Эту версию FindControl метода не следует переопределять. (Унаследовано от Control)
FindControl(String)	Выполняет поиск текущего контейнера именования для элемента управления сервером с указанным `id` параметром. (Унаследовано от Control)
Focus()	Задает фокус ввода элементу управления. (Унаследовано от Control)
GetData()	Возвращает реализованный IEnumerableобъект, представляющий источник данных. (Унаследовано от BaseDataList)
GetDesignModeState()	Возвращает данные во время разработки для элемента управления. (Унаследовано от Control)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetRouteUrl(Object)	Возвращает URL-адрес, соответствующий набору параметров маршрута. (Унаследовано от Control)
GetRouteUrl(RouteValueDictionary)	Возвращает URL-адрес, соответствующий набору параметров маршрута. (Унаследовано от Control)
GetRouteUrl(String, Object)	Получает URL-адрес, соответствующий набору параметров маршрута и имени маршрута. (Унаследовано от Control)
GetRouteUrl(String, RouteValueDictionary)	Получает URL-адрес, соответствующий набору параметров маршрута и имени маршрута. (Унаследовано от Control)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
GetUniqueIDRelativeTo(Control)	Возвращает префиксированную часть UniqueID свойства указанного элемента управления. (Унаследовано от Control)
HasControls()	Определяет, содержит ли серверный элемент управления какие-либо дочерние элементы управления. (Унаследовано от Control)
HasEvents()	Возвращает значение, указывающее, регистрируются ли события для элемента управления или любых дочерних элементов управления. (Унаследовано от Control)
InitializeItem(DataListItem)	Инициализирует DataListItem объект на основе указанных шаблонов и стилей для типа элемента списка.
IsLiteralContent()	Определяет, содержит ли серверный элемент управления только литеральное содержимое. (Унаследовано от Control)
LoadControlState(Object)	Восстанавливает сведения о состоянии элемента управления из предыдущего запроса страницы, сохраненного методом SaveControlState() . (Унаследовано от Control)
LoadViewState(Object)	Загружает ранее сохраненное состояние DataList представления элемента управления.
MapPathSecure(String)	Извлекает физический путь, с которым сопоставляется виртуальный путь( абсолютный или относительный). (Унаследовано от Control)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
MergeStyle(Style)	Копирует все небланковые элементы указанного стиля в веб-элемент управления, но не перезаписывает существующие элементы стиля элемента управления. Этот метод используется главным образом разработчиками элементов управления. (Унаследовано от WebControl)
OnBubbleEvent(Object, EventArgs)	Определяет, передается ли событие для элемента управления сервером пользовательского интерфейса страницы.
OnCancelCommand(DataListCommandEventArgs)	Вызывает событие CancelCommand. Это позволяет предоставить пользовательский обработчик для события.
OnDataBinding(EventArgs)	DataBinding Вызывает событие BaseDataList элемента управления. (Унаследовано от BaseDataList)
OnDataPropertyChanged()	Вызывается при изменении одного из свойств идентификации источника данных, чтобы повторно привязать элемент управления, привязанный к данным. (Унаследовано от BaseDataList)
OnDataSourceViewChanged(Object, EventArgs)	Вызывает событие DataSourceViewChanged. (Унаследовано от BaseDataList)
OnDeleteCommand(DataListCommandEventArgs)	Вызывает событие DeleteCommand. Это позволяет предоставить пользовательский обработчик для события.
OnEditCommand(DataListCommandEventArgs)	Вызывает событие EditCommand. Это позволяет предоставить пользовательский обработчик для события.
OnInit(EventArgs)	Init Вызывает событие для DataList элемента управления.
OnItemCommand(DataListCommandEventArgs)	Вызывает событие ItemCommand. Это позволяет предоставить пользовательский обработчик для события.
OnItemCreated(DataListItemEventArgs)	Вызывает событие ItemCreated. Это позволяет предоставить пользовательский обработчик для события.
OnItemDataBound(DataListItemEventArgs)	Вызывает событие ItemDataBound. Это позволяет предоставить пользовательский обработчик для события.
OnLoad(EventArgs)	Вызывает событие Load. (Унаследовано от BaseDataList)
OnPreRender(EventArgs)	Вызывает событие PreRender. (Унаследовано от BaseDataList)
OnSelectedIndexChanged(EventArgs)	SelectedIndexChanged Вызывает событие BaseDataList элемента управления. (Унаследовано от BaseDataList)
OnUnload(EventArgs)	Вызывает событие Unload. (Унаследовано от Control)
OnUpdateCommand(DataListCommandEventArgs)	Вызывает событие UpdateCommand. Это позволяет предоставить пользовательский обработчик для события.
OpenFile(String)	Возвращает используемый Stream для чтения файла. (Унаследовано от Control)
PrepareControlHierarchy()	Подготавливает иерархию элементов управления для отрисовки в элементе DataList управления.
RaiseBubbleEvent(Object, EventArgs)	Назначает любые источники события и ее сведения родительскому элементу управления. (Унаследовано от Control)
RemovedControl(Control)	Вызывается после удаления дочернего Control элемента управления из Controls коллекции объекта. (Унаследовано от Control)
Render(HtmlTextWriter)	Отрисовывает элемент управления в указанный модуль записи HTML. (Унаследовано от BaseDataList)
RenderBeginTag(HtmlTextWriter)	Отрисовывает HTML-тег открывающего элемента управления указанному средству записи. Этот метод используется главным образом разработчиками элементов управления. (Унаследовано от WebControl)
RenderChildren(HtmlTextWriter)	Выводит содержимое дочерних элементов управления сервера в предоставленный HtmlTextWriter объект, который записывает содержимое для отрисовки на клиенте. (Унаследовано от Control)
RenderContents(HtmlTextWriter)	Отрисовывает элементы списка в элементе DataList управления.
RenderControl(HtmlTextWriter, ControlAdapter)	Выводит содержимое элемента управления сервером в предоставленный HtmlTextWriter объект с помощью предоставленного ControlAdapter объекта. (Унаследовано от Control)
RenderControl(HtmlTextWriter)	Выводит содержимое сервера управления в предоставленный HtmlTextWriter объект и сохраняет сведения о трассировке элемента управления, если трассировка включена. (Унаследовано от Control)
RenderEndTag(HtmlTextWriter)	Отрисовывает html-закрывающий тег элемента управления в указанный модуль записи. Этот метод используется главным образом разработчиками элементов управления. (Унаследовано от WebControl)
ResolveAdapter()	Возвращает адаптер управления, отвечающий за отрисовку указанного элемента управления. (Унаследовано от Control)
ResolveClientUrl(String)	Получает URL-адрес, который может использоваться браузером. (Унаследовано от Control)
ResolveUrl(String)	Преобразует URL-адрес в url-адрес, который можно использовать на запрашиваемом клиенте. (Унаследовано от Control)
SaveControlState()	Сохраняет все изменения состояния управления сервером, которые произошли с момента публикации страницы на сервер. (Унаследовано от Control)
SaveViewState()	Сохраняет изменения в состоянии представления элемента управления после того, как страница была размещена на сервере.
SetDesignModeState(IDictionary)	Задает данные во время разработки для элемента управления. (Унаследовано от Control)
SetRenderMethodDelegate(RenderMethod)	Назначает делегат обработчика событий для отрисовки элемента управления сервером и его содержимого в родительский элемент управления. (Унаследовано от Control)
SetTraceData(Object, Object, Object)	Задает данные трассировки для трассировки данных отрисовки во время разработки, используя объект трассировки, ключ данных трассировки и значение данных трассировки. (Унаследовано от Control)
SetTraceData(Object, Object)	Задает данные трассировки для трассировки данных отрисовки во время разработки, используя ключ данных трассировки и значение данных трассировки. (Унаследовано от Control)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
TrackViewState()	Отслеживает изменения состояния представления элемента DataList управления, чтобы они могли храниться в свойстве элемента управления ViewState .

События

Имя	Описание
CancelCommand	Происходит при `Cancel` нажатии кнопки для элемента в элементе DataList управления.
DataBinding	Происходит, когда серверный элемент управления привязывается к источнику данных. (Унаследовано от Control)
DeleteCommand	Происходит при `Delete` нажатии кнопки для элемента в элементе DataList управления.
Disposed	Происходит при освобождении серверного элемента управления из памяти, который является последним этапом жизненного цикла управления сервера при запросе страницы ASP.NET. (Унаследовано от Control)
EditCommand	Происходит при `Edit` нажатии кнопки для элемента в элементе DataList управления.
Init	Происходит при инициализации серверного элемента управления, который является первым шагом в его жизненном цикле. (Унаследовано от Control)
ItemCommand	Происходит при нажатии любой кнопки в элементе DataList управления.
ItemCreated	Происходит на сервере при создании элемента в элементе DataList управления.
ItemDataBound	Происходит, когда элемент является данными, привязанными к элементу DataList управления.
Load	Происходит при загрузке серверного элемента управления в Page объект. (Унаследовано от Control)
PreRender	Происходит после Control загрузки объекта, но до отрисовки. (Унаследовано от Control)
SelectedIndexChanged	Происходит при выборе другого элемента в элементе управления перечислением данных между записями на сервере. (Унаследовано от BaseDataList)
Unload	Происходит при выгрузке серверного элемента управления из памяти. (Унаследовано от Control)
UpdateCommand	Происходит при `Update` нажатии кнопки для элемента в элементе DataList управления.

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

Имя	Описание
IAttributeAccessor.GetAttribute(String)	Возвращает атрибут веб-элемента управления с указанным именем. (Унаследовано от WebControl)
IAttributeAccessor.SetAttribute(String, String)	Задает атрибут веб-элемента управления указанным именем и значением. (Унаследовано от WebControl)
IControlBuilderAccessor.ControlBuilder	Описание этого элемента см. в разделе ControlBuilder. (Унаследовано от Control)
IControlDesignerAccessor.GetDesignModeState()	Описание этого элемента см. в разделе GetDesignModeState(). (Унаследовано от Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Описание этого элемента см. в разделе SetDesignModeState(IDictionary). (Унаследовано от Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Описание этого элемента см. в разделе SetOwnerControl(Control). (Унаследовано от Control)
IControlDesignerAccessor.UserData	Описание этого элемента см. в разделе UserData. (Унаследовано от Control)
IDataBindingsAccessor.DataBindings	Описание этого элемента см. в разделе DataBindings. (Унаследовано от Control)
IDataBindingsAccessor.HasDataBindings	Описание этого элемента см. в разделе HasDataBindings. (Унаследовано от Control)
IExpressionsAccessor.Expressions	Описание этого элемента см. в разделе Expressions. (Унаследовано от Control)
IExpressionsAccessor.HasExpressions	Описание этого элемента см. в разделе HasExpressions. (Унаследовано от Control)
IParserAccessor.AddParsedSubObject(Object)	Описание этого элемента см. в разделе AddParsedSubObject(Object). (Унаследовано от Control)
IRepeatInfoUser.GetItemStyle(ListItemType, Int32)	Описание этого элемента см. в разделе GetItemStyle(ListItemType, Int32).
IRepeatInfoUser.HasFooter	Описание этого элемента см. в разделе HasFooter.
IRepeatInfoUser.HasHeader	Описание этого элемента см. в разделе HasHeader.
IRepeatInfoUser.HasSeparators	Описание этого элемента см. в разделе HasSeparators.
IRepeatInfoUser.RenderItem(ListItemType, Int32, RepeatInfo, HtmlTextWriter)	Описание этого элемента см. в разделе RenderItem(ListItemType, Int32, RepeatInfo, HtmlTextWriter).
IRepeatInfoUser.RepeatedItemCount	Описание этого элемента см. в разделе RepeatedItemCount.

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

Имя	Описание
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	Включает поведение динамических данных для указанного элемента управления данными.
EnableDynamicData(INamingContainer, Type, Object)	Включает поведение динамических данных для указанного элемента управления данными.
EnableDynamicData(INamingContainer, Type)	Включает поведение динамических данных для указанного элемента управления данными.
FindDataSourceControl(Control)	Возвращает источник данных, связанный с элементом управления данными для указанного элемента управления.
FindFieldTemplate(Control, String)	Возвращает шаблон поля для указанного столбца в контейнере именования указанного элемента управления.
FindMetaTable(Control)	Возвращает объект метатабли для содержащего элемента управления данными.
GetDefaultValues(INamingContainer)	Возвращает коллекцию значений по умолчанию для указанного элемента управления данными.
GetMetaTable(INamingContainer)	Возвращает метаданные таблицы для указанного элемента управления данными.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	Задает сопоставление метаданных таблицы и значений по умолчанию для указанного элемента управления данными.
SetMetaTable(INamingContainer, MetaTable, Object)	Задает сопоставление метаданных таблицы и значений по умолчанию для указанного элемента управления данными.
SetMetaTable(INamingContainer, MetaTable)	Задает метаданные таблицы для указанного элемента управления данными.
TryGetMetaTable(INamingContainer, MetaTable)	Определяет, доступны ли метаданные таблицы.

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

См. также раздел

Обратная связь

Были ли сведения на этой странице полезными?

Поделиться через