BulletedList Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Создает элемент управления с маркированным списком элементов.
public ref class BulletedList : System::Web::UI::WebControls::ListControl, System::Web::UI::IPostBackEventHandlerpublic class BulletedList : System.Web.UI.WebControls.ListControl, System.Web.UI.IPostBackEventHandlertype BulletedList = class
inherit ListControl
interface IPostBackEventHandlerPublic Class BulletedList
Inherits ListControl
Implements IPostBackEventHandler- Наследование
- Реализации
Примеры
Этот раздел содержит два примера кода. В первом примере кода показано, как создать BulletedList элемент управления с элементами списка, отформатированными в виде кнопок ссылок. Во втором примере кода показано, как создать BulletedList элемент управления с помощью привязки данных для указания элементов списка.
В следующем примере кода показано, как создать BulletedList элемент управления с элементами списка, отформатированными в виде кнопок ссылок. Текст отображается в элементе Label управления при щелчке элемента списка.
<%@ 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 runat="server">
<title>BulletedList Click Example</title>
<script runat="server">
void ItemsBulletedList_Click(object sender, System.Web.UI.WebControls.BulletedListEventArgs e)
{
// Change the message displayed in the label based on the index
// of the list item that was clicked.
switch (e.Index)
{
case 0:
Message.Text = "You clicked list item 1.";
break;
case 1:
Message.Text = "You clicked list item 2.";
break;
case 2:
Message.Text = "You clicked list item 3.";
break;
default:
throw new Exception("You did not click a valid list item.");
break;
}
}
</script>
</head>
<body>
<h3>BulletedList Click Example</h3>
<form id="form1" runat="server">
<p>Click on an item in the list to raise the Click event.</p>
<asp:BulletedList id="ItemsBulletedList"
BulletStyle="Disc"
DisplayMode="LinkButton"
OnClick="ItemsBulletedList_Click"
runat="server">
<asp:ListItem Value="http://www.cohowinery.com">Coho Winery</asp:ListItem>
<asp:ListItem Value="http://www.contoso.com">Contoso, Ltd.</asp:ListItem>
<asp:ListItem Value="http://www.tailspintoys.com">Tailspin Toys</asp:ListItem>
</asp:BulletedList>
<asp:Label id="Message"
Font-Size="12"
Width="168px"
Font-Bold="True"
runat="server"
AssociatedControlID="ItemsBulletedList"/>
</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 runat="server">
<title>BulletedList Click Example</title>
<script runat="server">
Sub ItemsBulletedList_Click(ByVal sender As Object, _
ByVal e As System.Web.UI.WebControls.BulletedListEventArgs)
' Change the message displayed in the label based on the index
' of the list item that was clicked.
Select Case (e.Index)
Case 0
Message.Text = "You clicked list item 1."
Case 1
Message.Text = "You clicked list item 2."
Case 2
Message.Text = "You clicked list item 3."
Case Else
Throw New Exception("You did not click a valid list item.")
End Select
End Sub
</script>
</head>
<body>
<h3>BulletedList Click Example</h3>
<form id="form1" runat="server">
<p>Click on an item in the list to raise the Click event.</p>
<asp:BulletedList id="ItemsBulletedList"
BulletStyle="Disc"
DisplayMode="LinkButton"
OnClick="ItemsBulletedList_Click"
runat="server">
<asp:ListItem Value="http://www.cohowinery.com">Coho Winery</asp:ListItem>
<asp:ListItem Value="http://www.contoso.com">Contoso, Ltd.</asp:ListItem>
<asp:ListItem Value="http://www.tailspintoys.com">Tailspin Toys</asp:ListItem>
</asp:BulletedList>
<asp:Label id="Message"
Font-Size="12"
Width="168px"
Font-Bold="True"
runat="server"
AssociatedControlID="ItemsBulletedList"/>
</form>
</body>
</html>
В следующем примере кода показано, как создать BulletedList элемент управления с помощью привязки данных для указания элементов списка. Элементы списка форматируются в виде кнопок ссылок. Текст отображается в элементе Label управления при щелчке элемента списка.
<%@ 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 runat="server">
<title>BulletedList Class Data Binding Example</title>
<script runat="server">
void ProductsBulletedList_Click(object sender,
System.Web.UI.WebControls.BulletedListEventArgs e)
{
// Change the message displayed in the label based on the index
// of the list item that was clicked.
switch (e.Index)
{
case 0:
Message.Text = "Product 1 was clicked";
break;
case 1:
Message.Text = "Product 2 was clicked";
break;
case 2:
Message.Text = "Product 3 was clicked";
break;
case 3:
Message.Text = "Product 4 was clicked";
break;
default:
throw new Exception("You must click a valid list item.");
break;
}
}
</script>
</head>
<body>
<h3>BulletedList Class Data Binding Example</h3>
<form id="form1" runat="server">
<p>Click on an item in the list.</p>
<asp:BulletedList id="ProductsBulletedList"
BulletStyle="Disc"
DisplayMode="LinkButton"
DataTextField="ProductName"
DataSourceID="SqlDataSource1"
OnClick="ProductsBulletedList_Click"
runat="server">
</asp:BulletedList>
<asp:SqlDataSource id="SqlDataSource1"
ConnectionString="<%$ ConnectionStrings:NorthWindConnection%>"
runat="server"
SelectCommand="SELECT * FROM [Products] Where ProductID < 5">
</asp:SqlDataSource>
<asp:Label id="Message"
Font-Size="12"
Width="168px"
Font-Bold="True"
runat="server"/>
</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 runat="server">
<title>BulletedList Class Data Binding Example</title>
<script runat="server">
Sub ProductsBulletedList_Click(ByVal sender As Object, _
ByVal e As System.Web.UI.WebControls.BulletedListEventArgs)
' Change the message displayed in the label based on the index
' of the list item that was clicked.
Select Case (e.Index)
Case 0
Message.Text = "Product 1 was clicked"
Case 1
Message.Text = "Product 2 was clicked"
Case 2
Message.Text = "Product 3 was clicked"
Case 3
Message.Text = "Product 4 was clicked"
Case Else
Throw New Exception("You must click a valid list item.")
End Select
End Sub
</script>
</head>
<body>
<h3>BulletedList Class Data Binding Example</h3>
<form id="form1" runat="server">
<p>Click on an item in the list.</p>
<asp:BulletedList id="ProductsBulletedList"
BulletStyle="Disc"
DisplayMode="LinkButton"
DataTextField="ProductName"
DataSourceID="SqlDataSource1"
OnClick="ProductsBulletedList_Click"
runat="server">
</asp:BulletedList>
<asp:SqlDataSource id="SqlDataSource1"
ConnectionString="<%$ ConnectionStrings:NorthWindConnection%>"
runat="server"
SelectCommand="SELECT * FROM [Products] Where ProductID < 5">
</asp:SqlDataSource>
<asp:Label id="Message"
Font-Size="12"
Width="168px"
Font-Bold="True"
runat="server"/>
</form>
</body>
</html>
Комментарии
В этом разделе:
Введение
BulletedList Используйте элемент управления для создания списка элементов, отформатированных с маркерами. Чтобы указать отдельные элементы списка, которые должны отображаться в элементе BulletedList управления, поместите ListItem объект для каждой записи между открывающим и закрывающим тегами BulletedList элемента управления.
Чтобы указать тип маркера, используемый для отображения элементов списка в элементе BulletedList управления, присвойте BulletStyle свойству один из типов маркеров, определенных BulletStyle перечислением. В следующей таблице перечислены доступные стили маркеров.
| Стиль маркеров | Описание |
|---|---|
| NotSet | Не задано. |
| Numbered | Число. |
| LowerAlpha | Строчная буква. |
| UpperAlpha | Буква верхнего регистра. |
| LowerRoman | Римские цифры в нижнем регистре. |
| UpperRoman | Римские цифры в верхнем регистре. |
| Disc | Заполненный круг. |
| Circle | Пустой круг. |
| Square | Заполненный квадрат. |
| CustomImage | Пользовательский образ. |
Используйте свойство , FirstBulletNumber чтобы указать значение, которое начинает нумеровать элементы списка в упорядоченном BulletedList элементе управления. Значение, присвоенное свойству FirstBulletNumber , игнорируется, если свойству BulletStyle присвоено значение Discполя , Square, Circleили CustomImage . Если для свойства задано BulletStyleCustomImage значение , чтобы указать пользовательский образ для маркера BulletImageUrl , необходимо также задать свойство , чтобы указать расположение файла изображения.
Чтобы указать поведение отображения элементов списка в , присвойте BulletedListDisplayMode свойству одно из значений, определенных перечислением BulletedListDisplayMode . Определенным поведением отображения являются Text, HyperLinkи LinkButton.
Щелкнув гиперссылку, она переходит по URL-адресу. Используйте свойство , Value чтобы указать URL-адрес, по которому выполняется гиперссылка. Используйте свойство , Target чтобы указать фрейм или окно, в котором отображается веб-страница, на которую осуществляется переход при щелчке гиперссылки.
Если свойству DisplayMode присвоено значение LinkButton, BulletedList элемент управления отображает элементы списка в виде ссылок, которые возвращаются на сервер при щелчке. Чтобы программно управлять действиями, выполняемыми при нажатии кнопки ссылки, укажите обработчик Click события. Обратите внимание, что SelectedIndex свойства и SelectedItem наследуются от ListControl класса и неприменимы к элементу BulletedList управления . Используйте данные события класса , BulletedListEventArgs чтобы определить индекс кнопки ссылки в объекте BulletedList , который был нажат.
Элемент BulletedList управления также поддерживает привязку данных. Чтобы привязать BulletedList к источнику данных, можно использовать любой из предоставленных механизмов привязки данных. Дополнительные сведения см. в разделе Привязка к базам данных.
Специальные возможности
Разметка, отображаемая по умолчанию для этого элемента управления, может не соответствовать стандартам специальных возможностей, таким как рекомендации по обеспечению доступности веб-содержимого 1.0 (WCAG) с приоритетом 1. Дополнительные сведения о поддержке специальных возможностей для этого элемента управления см. в разделе Элементы управления ASP.NET и специальные возможности.
Декларативный синтаксис
<asp:BulletedList
AccessKey="string"
AppendDataBoundItems="True|False"
AutoPostBack="True|False"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
BulletImageUrl="uri"
BulletStyle="NotSet|Numbered|LowerAlpha|UpperAlpha|LowerRoman|
UpperRoman|Disc|Circle|Square|CustomImage"
CausesValidation="True|False"
CssClass="string"
DataMember="string"
DataSource="string"
DataSourceID="string"
DataTextField="string"
DataTextFormatString="string"
DataValueField="string"
DisplayMode="Text|HyperLink|LinkButton"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
FirstBulletNumber="integer"
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"
Height="size"
ID="string"
OnClick="Click event handler"
OnDataBinding="DataBinding event handler"
OnDataBound="DataBound event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnSelectedIndexChanged="SelectedIndexChanged event handler"
OnTextChanged="TextChanged event handler"
OnUnload="Unload event handler"
runat="server"
SkinID="string"
Style="string"
TabIndex="integer"
Target="string|_blank|_parent|_search|_self|_top"
ToolTip="string"
ValidationGroup="string"
Visible="True|False"
Width="size"
>
<asp:ListItem
Enabled="True|False"
Selected="True|False"
Text="string"
Value="string"
/>
</asp:BulletedList>
Конструкторы
| BulletedList() |
Инициализирует новый экземпляр класса BulletedList. |
Свойства
| AccessKey |
Возвращает или задает клавишу доступа, обеспечивающую быстрый переход к серверному веб-элементу управления. (Унаследовано от WebControl) |
| Adapter |
Возвращает конкретный адаптер браузера для элемента управления. (Унаследовано от Control) |
| AppendDataBoundItems |
Получает или задает значение, указывающее, удаляются ли элементы списка перед привязкой данных. (Унаследовано от ListControl) |
| AppRelativeTemplateSourceDirectory |
Возвращает или задает относительно приложения виртуальный каталог объекта Page или UserControl, который содержит этот элемент управления. (Унаследовано от Control) |
| Attributes |
Получает коллекцию произвольных атрибутов (только для отрисовки), которые не соответствуют свойствам элемента управления. (Унаследовано от WebControl) |
| AutoPostBack |
Получает или задает значение свойства AutoPostBack для базового класса. |
| BackColor |
Получает или задает цвет фона серверного веб-элемента управления. (Унаследовано от WebControl) |
| BindingContainer |
Возвращает элемент управления, который содержит привязку данных элемента управления. (Унаследовано от Control) |
| BorderColor |
Возвращает или задает цвет рамки элемента управления Веба. (Унаследовано от WebControl) |
| BorderStyle |
Получает или задает стиль границы серверного веб-элемента управления. (Унаследовано от WebControl) |
| BorderWidth |
Возвращает или задает ширину границы серверного веб-элемента управления. (Унаследовано от WebControl) |
| BulletImageUrl |
Получает или задает путь к изображению для каждого маркера, отображаемого в элементе управления BulletedList. |
| BulletStyle |
Получает или задает стиль маркера для элемента управления BulletedList. |
| CausesValidation |
Получает или задает значение, указывающее, выполняется ли проверка, когда выбирается элемент управления, производный от класса ListControl. (Унаследовано от ListControl) |
| ChildControlsCreated |
Возвращает значение, которое указывает, созданы ли дочерние элементы управления серверного элемента управления. (Унаследовано от Control) |
| ClientID |
Получает идентификатор элемента управления для HTML-разметки, созданной ASP.NET. (Унаследовано от Control) |
| ClientIDMode |
Возвращает или задает алгоритм, используемый для создания значения свойства ClientID. (Унаследовано от Control) |
| ClientIDSeparator |
Возвращает значение символа разделителя, используемого в свойстве ClientID. (Унаследовано от Control) |
| Context |
Возвращает объект HttpContext, связанный с серверным элементом управления для текущего веб-запроса. (Унаследовано от Control) |
| Controls |
Получает коллекцию ControlCollection для элемента управления. |
| ControlStyle |
Возвращает или задает стиль серверного веб-элемента управления. Это свойство используется преимущественно разработчиками элементов управления. (Унаследовано от WebControl) |
| ControlStyleCreated |
Возвращает значение, определяющее, был ли объект Style создан для свойства ControlStyle. Этот свойство в основном используется разработчиками элементов управления. (Унаследовано от WebControl) |
| CssClass |
Возвращает или задает класс каскадных листов стилей (CSS), преобразовываемый для просмотра в серверном веб-элементе управления на клиентском компьютере. (Унаследовано от WebControl) |
| DataItemContainer |
Возвращает ссылку на контейнер именования, если контейнер именования реализует класс IDataItemContainer. (Унаследовано от Control) |
| DataKeysContainer |
Возвращает ссылку на контейнер именования, если контейнер именования реализует класс IDataKeysControl. (Унаследовано от Control) |
| DataMember |
Получает или задает конкретную таблицу в DataSource, связываемом с элементом управления. (Унаследовано от ListControl) |
| DataSource |
Получает или задает источник данных, который заполняет фрагменты элемента управления "Список". (Унаследовано от ListControl) |
| DataSourceID |
Получает или задает идентификатор элемента управления, из которого элемент управления с привязкой к данным извлекает список элементов данных. (Унаследовано от DataBoundControl) |
| DataSourceObject |
Возвращает объект, реализующий интерфейс IDataSource, который предоставляет доступ к содержимому данных объекта. (Унаследовано от DataBoundControl) |
| DataTextField |
Получает или задает поле источника данных, предоставляющее текстовое содержимое элементов списка. (Унаследовано от ListControl) |
| DataTextFormatString |
Получает или задает строку форматирования, которая используется для управления отображением данных, связанных с элементом управления "Список". (Унаследовано от ListControl) |
| DataValueField |
Получает или задает поле источника данных, предоставляющее значение для каждого элемента списка. (Унаследовано от ListControl) |
| DesignMode |
Возвращает значение, указывающее, используется ли элемент управления на поверхности разработки. (Унаследовано от Control) |
| DisplayMode |
Получает или задает режим отображения содержимого списка в элементе управления BulletedList. |
| Enabled |
Возвращает или задает значение, определяющее, включен ли серверный веб-элемент управления. (Унаследовано от WebControl) |
| EnableTheming |
Возвращает или задает значение, указывающее, применяются ли темы к этому элементу управления. (Унаследовано от WebControl) |
| EnableViewState |
Получает или задает значение, указывающее запрашивающему клиенту, сохраняет ли серверный элемент управления состояние представления и состояние представления своих дочерних элементов управления. (Унаследовано от Control) |
| Events |
Возвращает список делегатов обработчиков событий элемента управления. Это свойство доступно только для чтения. (Унаследовано от Control) |
| FirstBulletNumber |
Получает или задает значение, с которого начинается нумерация элементов списка в нумерованном элементе управления BulletedList. |
| Font |
Возвращает свойства шрифта, связанные с серверным веб-элементом управления. (Унаследовано от WebControl) |
| ForeColor |
Возвращает или задает основной цвет (обычно это цвет текста) для серверного веб-элемента управления. (Унаследовано от WebControl) |
| HasAttributes |
Получает значение, определяющие наличие атрибутов у элемента управления. (Унаследовано от WebControl) |
| HasChildViewState |
Возвращает значение, которое указывает на наличие сохраненных параметров состояния представления у дочернего элемента серверного элемента управления. (Унаследовано от Control) |
| Height |
Получает или задает высоту серверного веб-элемента управления. (Унаследовано от WebControl) |
| ID |
Возвращает или задает программный идентификатор, назначенный серверному элементу управления. (Унаследовано от Control) |
| IdSeparator |
Возвращает символ, используемый для разделения идентификаторов элементов управления. (Унаследовано от Control) |
| Initialized |
Получает значение, указывающее, был ли проинициализирован элемент управления, присоединенный к данным. (Унаследовано от BaseDataBoundControl) |
| IsBoundUsingDataSourceID |
Получает значение, указывающее, установлено ли свойство DataSourceID. (Унаследовано от BaseDataBoundControl) |
| IsChildControlStateCleared |
Возвращает значение, указывающее, имеют ли элементы управления в этом элементе управления состояние элемента управления. (Унаследовано от Control) |
| IsDataBindingAutomatic |
Получаемое значение указывает, является ли привязка данных автоматической. (Унаследовано от BaseDataBoundControl) |
| IsEnabled |
Возвращает значение, определяющее, включен ли элемент управления. (Унаследовано от WebControl) |
| IsTrackingViewState |
Возвращает значение, отражающее сохранение изменений в состояние представления серверного элемента управления. (Унаследовано от Control) |
| IsUsingModelBinders |
Получает значение, указывающее, используется ли привязка модели. (Унаследовано от DataBoundControl) |
| IsViewStateEnabled |
Возвращает значение, указывающее, используется ли состояние представления для этого элемента управления. (Унаследовано от Control) |
| Items |
Возвращает коллекцию элементов в элементе управления «Список». (Унаследовано от ListControl) |
| ItemType |
Получает или задает имя типа элемента данных для привязки строго типизированных данных. (Унаследовано от DataBoundControl) |
| LoadViewStateByID |
Возвращает значение, указывающее, участвует ли элемент управления в загрузке состояния представления ID вместо индекса. (Унаследовано от Control) |
| NamingContainer |
Возвращает ссылку на контейнер именования элемента управления, создающий уникальное пространство имен для различения серверных элементов управления с одинаковыми значениями свойства ID. (Унаследовано от Control) |
| Page |
Возвращает ссылку на экземпляр Page, содержащий серверный элемент управления. (Унаследовано от Control) |
| Parent |
Возвращает ссылку на родительский элемент управления серверного элемента управления в иерархии элементов управления страницы. (Унаследовано от Control) |
| RenderingCompatibility |
Возвращает значение, которое задает версию ASP.NET, с которой совместим созданный HTML. (Унаследовано от Control) |
| RenderWhenDataEmpty |
Получает или задает значение, указывающее, отрисовывается ли элемент управления, если источник данных не содержит данных или если элемент управления не имеет привязки к данным. |
| RequiresDataBinding |
Получает или задает значение, указывающее, должен ли вызываться метод DataBind(). (Унаследовано от BaseDataBoundControl) |
| SelectArguments |
Возвращает объект DataSourceSelectArguments, который используется элементом управления с привязкой к данным при извлечении данных из элемента управления источником данных. (Унаследовано от DataBoundControl) |
| SelectedIndex |
Получает или задает индекс (начиная с нуля) выбранного элемента в элементе управления BulletedList. |
| SelectedItem |
Получает выбранный в настоящий момент элемент в элементе управления BulletedList. |
| SelectedValue |
Получает или задает свойство Value выбранного объекта ListItem в элементе управления BulletedList. |
| SelectMethod |
Имя метода, вызываемого для чтения данных. (Унаследовано от DataBoundControl) |
| Site |
Возвращает сведения о контейнере, который содержит текущий элемент управления при визуализации на поверхности конструктора. (Унаследовано от Control) |
| SkinID |
Возвращает или задает обложку, применяемую к элементу управления. (Унаследовано от WebControl) |
| Style |
Возвращает коллекцию атрибутов текста, которые будут отображены в виде атрибута стиля на внешнем теге серверного веб-элемента управления. (Унаследовано от WebControl) |
| SupportsDisabledAttribute |
Получает значение, указывающее, должен ли элемент управления устанавливать для атрибута |
| TabIndex |
Возвращает или задает индекс перехода по клавише Tab для серверного веб-элемента управления. (Унаследовано от WebControl) |
| TagKey |
Получает значение HtmlTextWriterTag для указанного элемента управления BulletedList. |
| TagName |
Возвращает имя тега элемента управления. Это свойство используется преимущественно разработчиками элементов управления. (Унаследовано от WebControl) |
| Target |
Получает или задает целевое окно или фрейм, в которых отображается содержимое веб-страницы для перехода по щелчку гиперссылки в элементе управления BulletedList. |
| TemplateControl |
Возвращает или задает ссылку на шаблон, содержащий этот элемент управления. (Унаследовано от Control) |
| TemplateSourceDirectory |
Возвращает виртуальный каталог Page или UserControl, содержащий текущий серверный элемент управления. (Унаследовано от Control) |
| Text |
Получает или задает текст для элемента управления BulletedList. |
| ToolTip |
Возвращает или задает текст, который отображается при наведении указателя мыши на серверный веб-элемент управления. (Унаследовано от WebControl) |
| UniqueID |
Возвращает уникальный идентификатор серверного элемента управления в иерархии. (Унаследовано от Control) |
| ValidateRequestMode |
Возвращает или задает значение, указывающее, проверяет ли элемент управления полученный из браузера клиентский ввод на предмет потенциально опасных значений. (Унаследовано от Control) |
| ValidationGroup |
Получает или задает группу элементов управления, для которых элемент управления, производный от класса ListControl, вызывает проверку при обратной передаче на сервер. (Унаследовано от ListControl) |
| ViewState |
Возвращает словарь сведений о состоянии, позволяющих сохранять и восстанавливать состояние представления серверного элемента управления при нескольких запросах одной и той же страницы. (Унаследовано от Control) |
| ViewStateIgnoresCase |
Возвращает значение, указывающее, является ли объект StateBag нечувствительным к регистру. (Унаследовано от Control) |
| ViewStateMode |
Возвращает или задает режим состояния представления данного элемента управления. (Унаследовано от Control) |
| Visible |
Получает или задает значение, указывающее, отрисовывается ли серверный элемент управления как пользовательский интерфейс на странице. (Унаследовано от Control) |
| Width |
Получает или задает ширину серверного веб-элемента управления. (Унаследовано от WebControl) |
Методы
| AddAttributesToRender(HtmlTextWriter) |
Добавляет атрибуты и стили HTML для элемента управления BulletedList, которые должны быть отображены в указанном объекте HtmlTextWriter. |
| AddedControl(Control, Int32) |
Вызывается после добавления дочернего элемента управления в коллекцию Controls объекта Control. (Унаследовано от Control) |
| AddParsedSubObject(Object) |
Уведомляет серверный элемент управления, что элемент XML или HTML был проанализирован, и добавляет элемент в серверный элемент управления объекта ControlCollection. (Унаследовано от Control) |
| ApplyStyle(Style) |
Копирует любой непустой элемент указанного стиля в элемент управления Веба, перезаписывая уже существующие элементы стиля. Этот метод, в основном, используется разработчиками элементов управления. (Унаследовано от WebControl) |
| ApplyStyleSheetSkin(Page) |
Применяет свойства стиля, определенные в таблице стилей страницы, к элементу управления. (Унаследовано от Control) |
| BeginRenderTracing(TextWriter, Object) |
Запускает трассировку во время разработки данных отрисовки. (Унаследовано от Control) |
| BuildProfileTree(String, Boolean) |
Собирает сведения о серверном элементе управления и доставляет их свойству Trace, которое отображается при включенной на странице трассировке. (Унаследовано от Control) |
| ClearCachedClientID() |
Задает для кэшированного свойства ClientID значение |
| ClearChildControlState() |
Удаляет сведения о состоянии элемента управления для дочерних элементов управления серверного элемента управления. (Унаследовано от Control) |
| ClearChildState() |
Удаляет сведения о состоянии элемента управления и состоянии представления для всех дочерних элементов серверного элемента управления. (Унаследовано от Control) |
| ClearChildViewState() |
Удаляет сведения о состоянии представления для всех дочерних элементов серверного элемента управления. (Унаследовано от Control) |
| ClearEffectiveClientIDMode() |
Задает для свойства ClientIDMode текущего экземпляра элемента управления и любых его дочерних элементов управления значение Inherit. (Унаследовано от Control) |
| ClearSelection() |
Очищает выбор элементов в списке и задает значение false для свойства Selected всех элементов. (Унаследовано от ListControl) |
| ConfirmInitState() |
Устанавливает исходное состояние элемента управления, присоединенного к данным. (Унаследовано от BaseDataBoundControl) |
| CopyBaseAttributes(WebControl) |
Копирует не инкапсулированные объектом Style свойства из указанного серверного веб-элемента управления веб-сервера в элемент управления веб-сервера, откуда вызывается этот метод. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl) |
| CreateChildControls() |
Вызывается платформой страницы ASP.NET для уведомления серверных элементов управления, использующих составную реализацию, о необходимости создания дочерних элементов управления, содержащихся в них для обратной передачи или отрисовки. (Унаследовано от Control) |
| CreateControlCollection() |
Создает новый объект ControlCollection для хранения дочерних элементов управления (литеральных и серверных) серверного элемента управления. (Унаследовано от Control) |
| CreateControlStyle() |
Создает объект стиля, который используется внутри класса WebControl для реализации всех относящихся к стилю свойств. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl) |
| CreateDataSourceSelectArguments() |
Создает используемый по умолчанию объект DataSourceSelectArguments, применяемый элементом управления с привязкой к данным, если не заданы аргументы. (Унаследовано от DataBoundControl) |
| DataBind() |
Привязывает источник данных к вызываемому серверному элементу управления и всем его дочерним элементам управления. (Унаследовано от BaseDataBoundControl) |
| DataBind(Boolean) |
Привязывает источник данных к вызванному серверному элементу управления и всем его дочерними элементами управления с возможностью вызова события DataBinding. (Унаследовано от Control) |
| DataBindChildren() |
Привязывает источник данных к дочерним элементам управления серверного элемента управления. (Унаследовано от Control) |
| Dispose() |
Включает серверный элемент управления для выполнения окончательной чистки до освобождения памяти. (Унаследовано от Control) |
| EndRenderTracing(TextWriter, Object) |
Завершает трассировку во время разработки данных отрисовки. (Унаследовано от Control) |
| EnsureChildControls() |
Определяет наличие у серверного элемента управления дочерних элементов управления. Если дочерних элементов управления нет, они будут созданы. (Унаследовано от Control) |
| EnsureDataBound() |
Вызывает метод DataBind(), если установлено свойство DataSourceID и элемент управления, присоединенный к данным, помечен, как требующий привязки. (Унаследовано от BaseDataBoundControl) |
| EnsureID() |
Создает идентификатор для элементов управления, которые не имеют назначенного идентификатора. (Унаследовано от Control) |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| FindControl(String) |
Выполняет поиск серверного элемента управления с заданным параметром |
| FindControl(String, Int32) |
Выполняет поиск в текущем контейнере именования серверного элемента управления с указанным |
| Focus() |
Задает фокус ввода на элемент управления. (Унаследовано от Control) |
| GetData() |
Извлекает объект DataSourceView, используемый элементом управления с привязкой к данным для выполнения операций с данными. (Унаследовано от DataBoundControl) |
| GetDataSource() |
Извлекает интерфейс IDataSource, с которым связан элемент управления с привязкой к данным, если таковой существует. (Унаследовано от DataBoundControl) |
| 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) |
| IsLiteralContent() |
Определяет наличие у серверного элемента управления только текстового содержимого. (Унаследовано от Control) |
| LoadControlState(Object) |
Восстанавливает сведения о состоянии элемента управления предыдущего запроса страницы, сохраненные методом SaveControlState(). (Унаследовано от Control) |
| LoadViewState(Object) |
Загружает предварительно сохраненное состояние представления элемента управления DetailsView. (Унаследовано от ListControl) |
| MapPathSecure(String) |
Извлекает физический путь, к которому ведет виртуальный путь (абсолютный или относительный). (Унаследовано от Control) |
| MarkAsDataBound() |
Задает в данных о состоянии представления состояние элемента управления, соответствующее успешной привязке к данным. (Унаследовано от DataBoundControl) |
| MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
| MergeStyle(Style) |
Копирует любой непустой элемент указанного стиля в элемент управления Веба, но не перезаписывает уже существующие элементы стиля. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Определяет, передается ли событие серверного элемента управления вверх по иерархии серверных элементов управления пользовательского интерфейса страницы. (Унаследовано от Control) |
| OnClick(BulletedListEventArgs) |
Создает событие Click элемента управления BulletedList. |
| OnCreatingModelDataSource(CreatingModelDataSourceEventArgs) |
Вызывает событие CreatingModelDataSource. (Унаследовано от DataBoundControl) |
| OnDataBinding(EventArgs) |
Вызывает событие DataBinding. (Унаследовано от ListControl) |
| OnDataBound(EventArgs) |
Вызывает событие DataBound. (Унаследовано от BaseDataBoundControl) |
| OnDataPropertyChanged() |
Выполняет повторную привязку элемента управления к своим данным после того, как изменилось одно из свойств, идентифицирующих источник данных. (Унаследовано от DataBoundControl) |
| OnDataSourceViewChanged(Object, EventArgs) |
Вызывает событие DataSourceViewChanged. (Унаследовано от DataBoundControl) |
| OnInit(EventArgs) |
Обрабатывает событие Init. (Унаследовано от BaseDataBoundControl) |
| OnLoad(EventArgs) |
Обрабатывает событие Load. (Унаследовано от DataBoundControl) |
| OnPagePreLoad(Object, EventArgs) |
Устанавливает исходное состояние элемента управления, привязанного к данным, перед его загрузкой. (Унаследовано от DataBoundControl) |
| OnPreRender(EventArgs) |
Вызывает событие PreRender. (Унаследовано от ListControl) |
| OnSelectedIndexChanged(EventArgs) |
Вызывает событие SelectedIndexChanged. Это позволяет предоставить настраиваемый обработчик для события. (Унаследовано от ListControl) |
| OnTextChanged(EventArgs) |
Вызывает событие TextChanged. (Унаследовано от ListControl) |
| OnUnload(EventArgs) |
Вызывает событие Unload. (Унаследовано от Control) |
| OpenFile(String) |
Возвращает Stream, используемое для чтения файла. (Унаследовано от Control) |
| PerformDataBinding(IEnumerable) |
Привязывает указанный источник данных к элементу управления, производному от класса ListControl. (Унаследовано от ListControl) |
| PerformSelect() |
Извлекает данные из связанного источника данных. (Унаследовано от ListControl) |
| RaiseBubbleEvent(Object, EventArgs) |
Присваивает родительскому элементу управления все источники события и сведения о них. (Унаследовано от Control) |
| RaisePostBackEvent(String) |
Создает событие для элемента управления BulletedList, когда форма передается обратно на сервер. |
| RemovedControl(Control) |
Вызывается после удаления дочернего элемента управления из коллекции Controls объекта Control. (Унаследовано от Control) |
| Render(HtmlTextWriter) |
Записывает содержимое элемента управления BulletedList в указанный объект HtmlTextWriter для отображения на стороне клиента. |
| RenderBeginTag(HtmlTextWriter) |
Выводит открывающий HTML-тег элемента управления в указанное средство записи. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl) |
| RenderBulletText(ListItem, Int32, HtmlTextWriter) |
Прорисовывает маркированный текст для каждого элемента списка в элементе управления BulletedList. |
| RenderChildren(HtmlTextWriter) |
Выводит содержимое дочерних элементов серверного элемента управления в предоставленный объект HtmlTextWriter, который записывает это содержимое для подготовки к просмотру на клиенте. (Унаследовано от Control) |
| RenderContents(HtmlTextWriter) |
Прорисовывает элементы списка в элементе управления BulletedList как маркеры в указанный модуль HtmlTextWriter. |
| RenderControl(HtmlTextWriter) |
Выводит содержимое серверного элемента управления в указанный объект HtmlTextWriter и сохраняет сведения о трассировке элемента управления, если трассировка включена. (Унаследовано от Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Выводит серверный элемент управления в указанный объект HtmlTextWriter, используя указанный объект ControlAdapter. (Унаследовано от Control) |
| RenderEndTag(HtmlTextWriter) |
Отображает закрывающий HTML-тег элемента управления в указанное средство записи. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl) |
| ResolveAdapter() |
Возвращает адаптер элемента управления, отвечающий за отрисовку определенного элемента управления. (Унаследовано от Control) |
| ResolveClientUrl(String) |
Возвращает URL-адрес, который может использоваться браузером. (Унаследовано от Control) |
| ResolveUrl(String) |
Преобразует URL-адрес в адрес, доступный для клиента. (Унаследовано от Control) |
| SaveControlState() |
Сохраняет любые изменения состояния серверного элемента управления, произошедшие после отправки страницы обратно на сервер. (Унаследовано от Control) |
| SaveViewState() |
Сохраняет текущее состояние представления элемента управления, производного от класса ListControl, и элементов, которые он содержит. (Унаследовано от ListControl) |
| SetDesignModeState(IDictionary) |
Задает данные времени разработки для элемента управления. (Унаследовано от Control) |
| SetPostDataSelection(Int32) |
Задает свойство Selected элемента управления ListItem после отправки страницы. (Унаследовано от ListControl) |
| SetRenderMethodDelegate(RenderMethod) |
Назначает делегата обработчика событий для преобразования серверного элемента управления и его содержимого для просмотра в родительский элемент управления. (Унаследовано от Control) |
| SetTraceData(Object, Object) |
Задает данные трассировки для трассировки данных отрисовки во время разработки, используя ключ данных трассировки и значение данных трассировки. (Унаследовано от Control) |
| SetTraceData(Object, Object, Object) |
Задает данные трассировки для трассировки данных отрисовки во время разработки, используя трассируемый объект, ключ данных трассировки и значение данных трассировки. (Унаследовано от Control) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
| TrackViewState() |
Отмечает начальную точку для отслеживания и сохранения изменений состояния представления в элементе управления, производном от класса ListControl. (Унаследовано от ListControl) |
| ValidateDataSource(Object) |
Проверяет, может ли элемент управления с привязкой к данным, привязываемый к объекту, работать с этим объектом. (Унаследовано от DataBoundControl) |
| VerifyMultiSelect() |
Определяет, поддерживает ли элемент управления "Список" режим множественного выбора. (Унаследовано от ListControl) |
События
| CallingDataMethods |
Возникает при вызове методов данных. (Унаследовано от DataBoundControl) |
| Click |
Происходит при нажатии кнопки ссылки в элементе управления BulletedList. |
| CreatingModelDataSource |
Происходит, когда объект ModelDataSource создается. (Унаследовано от DataBoundControl) |
| DataBinding |
Происходит при привязке серверного элемента управления к источнику данных. (Унаследовано от Control) |
| DataBound |
Происходит после привязки серверного элемента управления к источнику данных. (Унаследовано от BaseDataBoundControl) |
| Disposed |
Происходит при освобождении памяти, занятой серверным элементом управления, т.е. на последнем этапе жизненного цикла серверного элемента управления при запросе страницы ASP.NET. (Унаследовано от Control) |
| Init |
Происходит при инициализации серверного элемента управления, который находится на первом этапе его жизненного цикла. (Унаследовано от Control) |
| Load |
Происходит при загрузке серверного элемента управления в объект Page. (Унаследовано от Control) |
| PreRender |
Происходит после загрузки объекта Control, но перед отрисовкой. (Унаследовано от Control) |
| SelectedIndexChanged |
Возникает, когда происходит изменение выбора элементов в элементе управления "Список" между отправками на сервер. (Унаследовано от ListControl) |
| TextChanged |
Происходит, когда изменяются свойства Text и SelectedValue. (Унаследовано от ListControl) |
| Unload |
Происходит при выгрузке серверного элемента управления из памяти. (Унаследовано от Control) |
Явные реализации интерфейса
Методы расширения
| EnablePersistedSelection(BaseDataBoundControl) |
Устаревшие..
Включает возможность сохранения в элементах управления данными, поддерживающих выделение и разбиение по страницам. |
| FindDataSourceControl(Control) |
Возвращает источник данных, связанный с элементом управления данными, для заданного элемента управления. |
| FindFieldTemplate(Control, String) |
Возвращает шаблон поля для заданного столбца в контейнере именования заданного элемента управления. |
| FindMetaTable(Control) |
Возвращает объект метатаблицы для контейнерного элемента управления данными. |
Применяется к
См. также раздел
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по