CheckBoxList Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Создает группу флажка с несколькими параметрами, которая может быть динамически создана путем привязки элемента управления к источнику данных.
public ref class CheckBoxList : System::Web::UI::WebControls::ListControl, System::Web::UI::INamingContainer, System::Web::UI::IPostBackDataHandler, System::Web::UI::WebControls::IRepeatInfoUserpublic class CheckBoxList : System.Web.UI.WebControls.ListControl, System.Web.UI.INamingContainer, System.Web.UI.IPostBackDataHandler, System.Web.UI.WebControls.IRepeatInfoUsertype CheckBoxList = class
inherit ListControl
interface IRepeatInfoUser
interface INamingContainer
interface IPostBackDataHandlerPublic Class CheckBoxList
Inherits ListControl
Implements INamingContainer, IPostBackDataHandler, IRepeatInfoUser- Наследование
- Наследование
- Реализации
Примеры
В следующем примере кода показано, как создать CheckBoxList элемент управления на веб-странице.
Замечание
В следующем примере кода используется модель кода с одним файлом и может не работать правильно, если она копируется непосредственно в файл программной части. Этот пример кода должен быть скопирован в пустой текстовый файл с расширением .aspx. Дополнительные сведения о модели кода веб-форм см. в разделе ASP.NET модель кода веб-форм.
<%@ Page Language="C#" AutoEventWireup="True" %>
<!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> CheckBoxList Example </title>
<script runat="server">
void Check_Clicked(Object sender, EventArgs e)
{
Message.Text = "Selected Item(s):<br /><br />";
// Iterate through the Items collection of the CheckBoxList
// control and display the selected items.
for (int i=0; i<checkboxlist1.Items.Count; i++)
{
if (checkboxlist1.Items[i].Selected)
{
Message.Text += checkboxlist1.Items[i].Text + "<br />";
}
}
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3> CheckBoxList Example </h3>
Select items from the CheckBoxList.
<br /><br />
<asp:CheckBoxList id="checkboxlist1"
AutoPostBack="True"
CellPadding="5"
CellSpacing="5"
RepeatColumns="2"
RepeatDirection="Vertical"
RepeatLayout="Flow"
TextAlign="Right"
OnSelectedIndexChanged="Check_Clicked"
runat="server">
<asp:ListItem>Item 1</asp:ListItem>
<asp:ListItem>Item 2</asp:ListItem>
<asp:ListItem>Item 3</asp:ListItem>
<asp:ListItem>Item 4</asp:ListItem>
<asp:ListItem>Item 5</asp:ListItem>
<asp:ListItem>Item 6</asp:ListItem>
</asp:CheckBoxList>
<br /><br />
<asp:label id="Message" runat="server" AssociatedControlID="checkboxlist1"/>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!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> CheckBoxList Example </title>
<script runat="server">
Sub Check_Clicked(sender as Object, e As EventArgs)
Message.Text = "Selected Item(s):<br /><br />"
' Iterate through the Items collection of the CheckBoxList
' control and display the selected items.
Dim i As Integer
For i=0 To checkboxlist1.Items.Count - 1
If checkboxlist1.Items(i).Selected Then
Message.Text &= checkboxlist1.Items(i).Text & "<br />"
End If
Next
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3> CheckBoxList Example </h3>
Select items from the CheckBoxList.
<br /><br />
<asp:CheckBoxList id="checkboxlist1"
AutoPostBack="True"
CellPadding="5"
CellSpacing="5"
RepeatColumns="2"
RepeatDirection="Vertical"
RepeatLayout="Flow"
TextAlign="Right"
OnSelectedIndexChanged="Check_Clicked"
runat="server">
<asp:ListItem>Item 1</asp:ListItem>
<asp:ListItem>Item 2</asp:ListItem>
<asp:ListItem>Item 3</asp:ListItem>
<asp:ListItem>Item 4</asp:ListItem>
<asp:ListItem>Item 5</asp:ListItem>
<asp:ListItem>Item 6</asp:ListItem>
</asp:CheckBoxList>
<br /><br />
<asp:label id="Message" runat="server" AssociatedControlID="checkboxlist1"/>
</form>
</body>
</html>
Комментарии
Содержание этой статьи
Введение
Элемент CheckBoxList управления предоставляет группу флажка с несколькими параметрами, которую можно динамически создать с помощью привязки данных. Он содержит коллекцию Items с элементами, соответствующими отдельным элементам в списке. Чтобы определить, какие элементы проверяются, выполните итерацию по коллекции и проверьте Selected свойство каждого элемента в списке.
Замечание
Можно также использовать несколько CheckBox элементов управления. Элемент CheckBoxList управления упрощает создание набора флажков с помощью привязки данных, а отдельный CheckBox элемент управления обеспечивает более широкий контроль над макетом.
Указание макета списка
Вы можете указать способ отображения списка с помощью RepeatLayout свойств и RepeatDirection свойств. Сведения о параметрах макета см. в RepeatLayout перечислении.
По умолчанию для RepeatDirection задано значение RepeatDirection.Vertical. Задание этого свойства для RepeatDirection.Horizontal отображения списка по горизонтали. Некоторые RepeatLayout параметры не допускают горизонтального макета. Дополнительную информацию см. в перечислении RepeatLayout.
Указание элементов списка
Чтобы указать элементы, которые нужно отображать в элементе CheckBoxList управления, поместите ListItem элемент для каждой CheckBoxList записи между открывающим и закрывающим тегами элемента управления.
Элемент CheckBoxList управления также поддерживает привязку данных. Чтобы привязать элемент управления к источнику данных, сначала создайте источник данных, например один из DataSourceControl объектов, который содержит элементы, отображаемые в элементе управления. Затем используйте DataBind метод для привязки источника данных к элементу CheckBoxList управления.
DataTextField
DataValueField Используйте свойства, чтобы указать поле в источнике данных, чтобы привязаться к Text каждому Value элементу списка в элементе управления соответственно. Теперь элемент CheckBoxList управления отобразит сведения из источника данных.
Чтобы определить выбранные элементы в элементе CheckBoxList управления, выполните итерацию по Items коллекции и проверьте Selected свойство каждого элемента в коллекции.
Предостережение
Этот элемент управления можно использовать для отображения входных данных пользователей, которые могут включать вредоносный скрипт клиента. Проверьте все сведения, отправляемые клиентом для исполняемого скрипта, инструкций SQL или другого кода перед отображением в приложении. Перед отображением входного текста в элементе управления можно использовать элементы управления проверкой. ASP.NET предоставляет функцию проверки входных запросов для блокировки скрипта и HTML в входных данных пользователя. Дополнительные сведения см. в статье "Защита стандартных элементов управления", "Практическое руководство. Защита от эксплойтов скриптов в веб-приложении путем применения кодировки HTML к строкам" и проверки входных данных пользователей на веб-страницах ASP.NET.
Доступность
Сведения о настройке этого элемента управления таким образом, чтобы он создавал разметку, соответствующую стандартам специальных возможностей, см. в разделе "Специальные возможности" в Visual Studio и ASP.NET и ASP.NET элементы управления и специальные возможности.
Декларативный синтаксис
<asp:CheckBoxList
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"
CausesValidation="True|False"
CellPadding="integer"
CellSpacing="integer"
CssClass="string"
DataMember="string"
DataSource="string"
DataSourceID="string"
DataTextField="string"
DataTextFormatString="string"
DataValueField="string"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="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"
Height="size"
ID="string"
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"
RepeatColumns="integer"
RepeatDirection="Horizontal|Vertical"
RepeatLayout="Table|Flow|OrderedList|UnorderedList"
runat="server"
SelectedIndex="integer"
SelectedValue="string"
SkinID="string"
Style="string"
TabIndex="integer"
TextAlign="Left|Right"
ToolTip="string"
ValidationGroup="string"
Visible="True|False"
Width="size"
>
<asp:ListItem
Enabled="True|False"
Selected="True|False"
Text="string"
Value="string"
/>
</asp:CheckBoxList>
Конструкторы
| Имя | Описание |
|---|---|
| CheckBoxList() |
Инициализирует новый экземпляр класса CheckBoxList. |
Свойства
| Имя | Описание |
|---|---|
| AccessKey |
Возвращает или задает ключ доступа, позволяющий быстро перейти к элементу управления веб-сервера. (Унаследовано от WebControl) |
| Adapter |
Возвращает адаптер, зависящий от браузера, для элемента управления. (Унаследовано от Control) |
| AppendDataBoundItems |
Возвращает или задает значение, указывающее, очищаются ли элементы списка перед привязкой данных. (Унаследовано от ListControl) |
| AppRelativeTemplateSourceDirectory |
Возвращает или задает относительный к приложению виртуальный каталог Page объекта или UserControl объекта, содержащего этот элемент управления. (Унаследовано от Control) |
| Attributes |
Возвращает коллекцию произвольных атрибутов (только для отрисовки), которые не соответствуют свойствам элемента управления. (Унаследовано от WebControl) |
| AutoPostBack |
Возвращает или задает значение, указывающее, происходит ли обратная отправка на сервер автоматически при изменении выбора списка пользователем. (Унаследовано от ListControl) |
| BackColor |
Возвращает или задает цвет фона элемента управления веб-сервера. (Унаследовано от WebControl) |
| BindingContainer |
Возвращает элемент управления, содержащий привязку данных этого элемента управления. (Унаследовано от Control) |
| BorderColor |
Возвращает или задает цвет границы веб-элемента управления. (Унаследовано от WebControl) |
| BorderStyle |
Возвращает или задает стиль границы элемента управления веб-сервера. (Унаследовано от WebControl) |
| BorderWidth |
Возвращает или задает ширину границы элемента управления веб-сервера. (Унаследовано от WebControl) |
| CausesValidation |
Возвращает или задает значение, указывающее, выполняется ли проверка при щелчке элемента управления, производного от ListControl класса. (Унаследовано от ListControl) |
| CellPadding |
Получает или задает расстояние (в пикселях) между границей и содержимым ячейки. |
| CellSpacing |
Получает или задает расстояние (в пикселях) между ячейками. |
| ChildControlsCreated |
Возвращает значение, указывающее, были ли созданы дочерние элементы управления сервера. (Унаследовано от Control) |
| ClientID |
Возвращает идентификатор элемента управления для разметки HTML, созданной ASP.NET. (Унаследовано от Control) |
| ClientIDMode |
Возвращает или задает алгоритм, используемый для создания значения ClientID свойства. (Унаследовано от Control) |
| ClientIDSeparator |
Возвращает значение символа, представляющее символ разделителя, используемый в свойстве ClientID . (Унаследовано от Control) |
| Context |
HttpContext Возвращает объект, связанный с серверным элементом управления для текущего веб-запроса. (Унаследовано от Control) |
| Controls |
ControlCollection Возвращает объект, представляющий дочерние элементы управления для указанного серверного элемента управления в иерархии пользовательского интерфейса. (Унаследовано от Control) |
| 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) |
| Enabled |
Возвращает или задает значение, указывающее, включен ли элемент управления веб-сервера. (Унаследовано от WebControl) |
| EnableTheming |
Возвращает или задает значение, указывающее, применяются ли темы к этому элементу управления. (Унаследовано от WebControl) |
| EnableViewState |
Возвращает или задает значение, указывающее, сохраняет ли серверный элемент управления состояние представления и состояние представления всех дочерних элементов управления, содержащихся в нем, для запрашивающего клиента. (Унаследовано от Control) |
| Events |
Возвращает список делегатов обработчика событий для элемента управления. Это свойство доступно только для чтения. (Унаследовано от Control) |
| Font |
Возвращает свойства шрифта, связанные с элементом управления веб-сервера. (Унаследовано от WebControl) |
| ForeColor |
Возвращает или задает цвет переднего плана (обычно цвет текста) элемента управления веб-сервера. (Унаследовано от WebControl) |
| HasAttributes |
Возвращает значение, указывающее, имеет ли элемент управления набор атрибутов. (Унаследовано от WebControl) |
| HasChildViewState |
Получает значение, указывающее, имеют ли дочерние элементы управления текущего элемента управления серверным элементом управления какие-либо сохраненные параметры состояния представления. (Унаследовано от Control) |
| HasFooter |
Возвращает значение, указывающее, содержит ли CheckBoxList элемент управления раздел нижнего колонтитула. |
| HasHeader |
Возвращает значение, указывающее, содержит ли CheckBoxList элемент управления раздел заголовка. |
| HasSeparators |
Возвращает значение, указывающее, содержит ли CheckBoxList элемент управления разделитель между элементами в списке. |
| 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 |
Возвращает или задает значение, указывающее, отображается ли элемент управления, если источник данных не имеет данных или элемент управления не привязан к данным. |
| RepeatColumns |
Возвращает или задает количество столбцов, отображаемых в элементе CheckBoxList управления. |
| RepeatDirection |
Возвращает или задает значение, указывающее, отображается ли элемент управления вертикально или горизонтально. |
| RepeatedItemCount |
Возвращает количество элементов списка в элементе CheckBoxList управления. |
| RepeatLayout |
Возвращает или задает значение, указывающее, будет ли список отображаться с помощью |
| RequiresDataBinding |
Возвращает или задает значение, указывающее, следует ли DataBind() вызывать метод. (Унаследовано от BaseDataBoundControl) |
| SelectArguments |
DataSourceSelectArguments Возвращает объект, который элемент управления, привязанный к данным, используется при получении данных из элемента управления источниками данных. (Унаследовано от DataBoundControl) |
| SelectedIndex |
Возвращает или задает самый низкий порядковый индекс выбранных элементов в списке. (Унаследовано от ListControl) |
| SelectedItem |
Возвращает выбранный элемент с наименьшим индексом в элементе управления списком. (Унаследовано от ListControl) |
| SelectedValue |
Возвращает значение выбранного элемента в элементе управления списком или выбирает элемент в элементе управления списком, который содержит указанное значение. (Унаследовано от ListControl) |
| SelectMethod |
Имя метода, вызываемого для чтения данных. (Унаследовано от DataBoundControl) |
| Site |
Получает сведения о контейнере, на котором размещается текущий элемент управления при отрисовки на поверхности конструктора. (Унаследовано от Control) |
| SkinID |
Возвращает или задает кожу, применяемую к элементу управления. (Унаследовано от WebControl) |
| Style |
Возвращает коллекцию текстовых атрибутов, которые будут отображаться как атрибут стиля во внешнем теге элемента управления веб-сервера. (Унаследовано от WebControl) |
| SupportsDisabledAttribute |
Возвращает значение, указывающее, должен ли элемент управления задать |
| TabIndex |
Возвращает или задает индекс табуляции элемента управления веб-сервера. (Унаследовано от WebControl) |
| TagKey |
HtmlTextWriterTag Возвращает значение элемента ListControl управления. (Унаследовано от ListControl) |
| TagName |
Возвращает имя тега элемента управления. Это свойство используется главным образом разработчиками элементов управления. (Унаследовано от WebControl) |
| TemplateControl |
Возвращает или задает ссылку на шаблон, содержащий этот элемент управления. (Унаследовано от Control) |
| TemplateSourceDirectory |
Возвращает виртуальный Page каталог или UserControl содержащий текущий серверный элемент управления. (Унаследовано от Control) |
| Text |
Возвращает или задает SelectedValue свойство ListControl элемента управления. (Унаследовано от ListControl) |
| TextAlign |
Возвращает или задает выравнивание текста для флажков в группе. |
| ToolTip |
Возвращает или задает текст, отображаемый при наведении указателя мыши на элемент управления веб-сервера. (Унаследовано от WebControl) |
| UniqueID |
Возвращает уникальный иерархический идентификатор для элемента управления сервером. (Унаследовано от Control) |
| ValidateRequestMode |
Возвращает или задает значение, указывающее, проверяет ли элемент управления входные данные клиента из браузера для потенциально опасных значений. (Унаследовано от Control) |
| ValidationGroup |
Возвращает или задает группу элементов управления, для которых элемент управления, производный от ListControl класса, вызывает проверку при обратной отправке на сервер. (Унаследовано от ListControl) |
| ViewState |
Получает словарь сведений о состоянии, позволяющий сохранять и восстанавливать состояние представления серверного элемента управления в нескольких запросах на одну и ту же страницу. (Унаследовано от Control) |
| ViewStateIgnoresCase |
Возвращает значение, указывающее, является ли StateBag объект нечувствительным к регистру. (Унаследовано от Control) |
| ViewStateMode |
Возвращает или задает режим состояния представления этого элемента управления. (Унаследовано от Control) |
| Visible |
Возвращает или задает значение, указывающее, отображается ли серверный элемент управления в виде пользовательского интерфейса на странице. (Унаследовано от Control) |
| Width |
Возвращает или задает ширину элемента управления веб-сервера. (Унаследовано от WebControl) |
Методы
| Имя | Описание |
|---|---|
| AddAttributesToRender(HtmlTextWriter) |
Применяет атрибуты и стили HTML для отрисовки к указанному HtmlTextWriter объекту. (Унаследовано от ListControl) |
| AddedControl(Control, Int32) |
Вызывается после добавления дочернего Control элемента управления в Controls коллекцию объекта. (Унаследовано от 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() |
Очищает выбор списка и задает Selected для свойства всех элементов значение false. (Унаследовано от ListControl) |
| ConfirmInitState() |
Задает инициализированное состояние элемента управления, привязанного к данным. (Унаследовано от BaseDataBoundControl) |
| CopyBaseAttributes(WebControl) |
Копирует свойства, не инкапсулированные Style объектом из указанного элемента управления веб-сервера, в элемент управления веб-сервера, из который вызывается этот метод. Этот метод используется главным образом разработчиками элементов управления. (Унаследовано от WebControl) |
| CreateChildControls() |
Вызывается платформой страницы ASP.NET, чтобы уведомить серверные элементы управления, использующие реализацию на основе композиции, чтобы создать все дочерние элементы управления, содержащиеся в подготовке к публикации обратной или отрисовки. (Унаследовано от Control) |
| CreateControlCollection() |
Создает новый ControlCollection объект для хранения дочерних элементов управления (как литерала, так и сервера) элемента управления сервером. (Унаследовано от Control) |
| CreateControlStyle() |
Создает объект стиля, который используется внутри CheckBoxList элемента управления для реализации всех свойств, связанных со стилем. |
| CreateDataSourceSelectArguments() |
Создает объект по умолчанию DataSourceSelectArguments , используемый элементом управления с привязкой к данным, если аргументы не указаны. (Унаследовано от DataBoundControl) |
| DataBind() |
Привязывает источник данных к вызываемой серверной системе управления и всем дочерним элементам управления. (Унаследовано от Control) |
| 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, Int32) |
Выполняет поиск текущего контейнера именования для элемента управления сервером с указанным идентификатором и смещением пути. Метод FindControl(String, Int32) всегда возвращает CheckBoxList объект. |
| FindControl(String) |
Выполняет поиск текущего контейнера именования для элемента управления сервером с указанным |
| Focus() |
Задает фокус ввода элементу управления. (Унаследовано от Control) |
| GetData() |
Извлекает DataSourceView объект, который элемент управления с привязкой к данным использует для выполнения операций с данными. (Унаследовано от DataBoundControl) |
| GetDataSource() |
Извлекает IDataSource интерфейс, с которым связан элемент управления с привязкой к данным, если таковой имеется. (Унаследовано от DataBoundControl) |
| GetDesignModeState() |
Возвращает данные во время разработки для элемента управления. (Унаследовано от Control) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetItemStyle(ListItemType, Int32) |
Извлекает стиль указанного типа элемента по указанному индексу в элементе управления списком. |
| 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) |
| LoadPostData(String, NameValueCollection) |
Обрабатывает опубликованные данные для CheckBoxList элемента управления. |
| LoadViewState(Object) |
Загружает ранее сохраненное состояние DetailsView представления элемента управления. (Унаследовано от ListControl) |
| MapPathSecure(String) |
Извлекает физический путь, с которым сопоставляется виртуальный путь( абсолютный или относительный). (Унаследовано от Control) |
| MarkAsDataBound() |
Задает состояние элемента управления в состоянии представления как успешно привязанное к данным. (Унаследовано от DataBoundControl) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| MergeStyle(Style) |
Копирует все небланковые элементы указанного стиля в веб-элемент управления, но не перезаписывает существующие элементы стиля элемента управления. Этот метод используется главным образом разработчиками элементов управления. (Унаследовано от WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Определяет, передается ли событие для элемента управления сервером пользовательского интерфейса страницы. (Унаследовано от Control) |
| OnCreatingModelDataSource(CreatingModelDataSourceEventArgs) |
Вызывает событие CreatingModelDataSource. (Унаследовано от DataBoundControl) |
| OnDataBinding(EventArgs) |
Вызывает событие DataBinding. (Унаследовано от ListControl) |
| OnDataBound(EventArgs) |
Вызывает событие DataBound. (Унаследовано от BaseDataBoundControl) |
| OnDataPropertyChanged() |
Повторно привязывает элемент управления, привязанный к данным, после изменения одного из свойств идентификации источника данных базы данных. (Унаследовано от DataBoundControl) |
| OnDataSourceViewChanged(Object, EventArgs) |
Вызывает событие DataSourceViewChanged. (Унаследовано от DataBoundControl) |
| OnInit(EventArgs) |
Вызывает событие Init. |
| OnInit(EventArgs) |
Вызывает событие Init. (Унаследовано от Control) |
| OnInit(EventArgs) |
Init Обрабатывает событие. (Унаследовано от BaseDataBoundControl) |
| OnLoad(EventArgs) |
Вызывает событие Load. (Унаследовано от Control) |
| OnLoad(EventArgs) |
Load Обрабатывает событие. (Унаследовано от DataBoundControl) |
| OnPagePreLoad(Object, EventArgs) |
Задает инициализированное состояние элемента управления, привязанного к данным, перед загрузкой элемента управления. (Унаследовано от DataBoundControl) |
| OnPreRender(EventArgs) |
Настраивает CheckBoxList элемент управления перед отрисовкой на клиенте. |
| 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) |
| RaisePostDataChangedEvent() |
Уведомляет приложение ASP.NET о том, что состояние CheckBoxList элемента управления изменилось. |
| RemovedControl(Control) |
Вызывается после удаления дочернего Control элемента управления из Controls коллекции объекта. (Унаследовано от Control) |
| Render(HtmlTextWriter) |
Отображается CheckBoxList на клиенте. |
| RenderBeginTag(HtmlTextWriter) |
Отрисовывает HTML-тег открывающего элемента управления указанному средству записи. Этот метод используется главным образом разработчиками элементов управления. (Унаследовано от WebControl) |
| RenderChildren(HtmlTextWriter) |
Выводит содержимое дочерних элементов управления сервера в предоставленный HtmlTextWriter объект, который записывает содержимое для отрисовки на клиенте. (Унаследовано от Control) |
| RenderContents(HtmlTextWriter) |
Отрисовывает элементы в элементе ListControl управления. (Унаследовано от ListControl) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Выводит содержимое элемента управления сервером в предоставленный HtmlTextWriter объект с помощью предоставленного ControlAdapter объекта. (Унаследовано от Control) |
| RenderControl(HtmlTextWriter) |
Выводит содержимое сервера управления в предоставленный HtmlTextWriter объект и сохраняет сведения о трассировке элемента управления, если трассировка включена. (Унаследовано от Control) |
| RenderEndTag(HtmlTextWriter) |
Отрисовывает html-закрывающий тег элемента управления в указанный модуль записи. Этот метод используется главным образом разработчиками элементов управления. (Унаследовано от WebControl) |
| RenderItem(ListItemType, Int32, RepeatInfo, HtmlTextWriter) |
Отрисовывает элемент списка в элементе CheckBoxList управления. |
| ResolveAdapter() |
Возвращает адаптер управления, отвечающий за отрисовку указанного элемента управления. (Унаследовано от Control) |
| ResolveClientUrl(String) |
Получает URL-адрес, который может использоваться браузером. (Унаследовано от Control) |
| ResolveUrl(String) |
Преобразует URL-адрес в url-адрес, который можно использовать на запрашиваемом клиенте. (Унаследовано от Control) |
| SaveControlState() |
Сохраняет все изменения состояния управления сервером, которые произошли с момента публикации страницы на сервер. (Унаследовано от Control) |
| SaveViewState() |
Сохраняет текущее состояние ListControl представления элемента управления -derived и элементы, которые он содержит. (Унаследовано от ListControl) |
| SetDesignModeState(IDictionary) |
Задает данные во время разработки для элемента управления. (Унаследовано от Control) |
| SetPostDataSelection(Int32) |
Selected Задает свойство ListItem элемента управления после публикации страницы. (Унаследовано от ListControl) |
| SetRenderMethodDelegate(RenderMethod) |
Назначает делегат обработчика событий для отрисовки элемента управления сервером и его содержимого в родительский элемент управления. (Унаследовано от Control) |
| SetTraceData(Object, Object, Object) |
Задает данные трассировки для трассировки данных отрисовки во время разработки, используя объект трассировки, ключ данных трассировки и значение данных трассировки. (Унаследовано от Control) |
| SetTraceData(Object, Object) |
Задает данные трассировки для трассировки данных отрисовки во время разработки, используя ключ данных трассировки и значение данных трассировки. (Унаследовано от Control) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
| TrackViewState() |
Помечает начальную точку, чтобы начать отслеживание и сохранение изменений состояния представления в ListControl элементе управления -derived. (Унаследовано от ListControl) |
| ValidateDataSource(Object) |
Проверяет, что объект, к которому привязан элемент управления, привязанный к данным, является тем, с которым он может работать. (Унаследовано от DataBoundControl) |
| VerifyMultiSelect() |
Определяет, поддерживает ли элемент управления списком режим многоизбирания. (Унаследовано от ListControl) |
События
| Имя | Описание |
|---|---|
| CallingDataMethods |
Происходит при вызове методов данных. (Унаследовано от DataBoundControl) |
| 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) |
Явные реализации интерфейса
| Имя | Описание |
|---|---|
| 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) |
| IPostBackDataHandler.LoadPostData(String, NameValueCollection) |
Обрабатывает опубликованные CheckBoxList данные для элемента управления. |
| IPostBackDataHandler.RaisePostDataChangedEvent() |
Возникает при изменении опубликованных данных для элемента управления. |
| IRepeatInfoUser.GetItemStyle(ListItemType, Int32) |
Описание этого элемента см. в разделе GetItemStyle(ListItemType, Int32). |
| IRepeatInfoUser.HasFooter |
Возвращает значение, указывающее, содержит ли элемент управления списком раздел нижнего колонтитула. |
| IRepeatInfoUser.HasHeader |
Возвращает значение, указывающее, содержит ли элемент управления списком раздел заголовка. |
| IRepeatInfoUser.HasSeparators |
Возвращает значение, указывающее, содержит ли элемент управления списком разделитель между элементами в списке. |
| IRepeatInfoUser.RenderItem(ListItemType, Int32, RepeatInfo, HtmlTextWriter) |
Описание этого элемента см. в разделе RenderItem(ListItemType, Int32, RepeatInfo, HtmlTextWriter). |
| IRepeatInfoUser.RepeatedItemCount |
Возвращает количество элементов в элементе управления списком. |
Методы расширения
| Имя | Описание |
|---|---|
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Включает поведение динамических данных для указанного элемента управления данными. |
| EnableDynamicData(INamingContainer, Type, Object) |
Включает поведение динамических данных для указанного элемента управления данными. |
| EnableDynamicData(INamingContainer, Type) |
Включает поведение динамических данных для указанного элемента управления данными. |
| EnablePersistedSelection(BaseDataBoundControl) |
Устаревшие..
Позволяет сохранять выбор в элементах управления данными, поддерживающих выбор и разбиение по страницам. |
| 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) |
Определяет, доступны ли метаданные таблицы. |
Применяется к
См. также раздел
- ListControl
- CheckBox
- Элементы управления веб-сервера CheckBox и CheckBoxList
- Защита стандартных элементов управления
- Практическое руководство. Защита от эксплойтов скриптов в веб-приложении путем применения кодировки HTML к строкам
- Общие сведения о проверке входных данных пользователей на веб-страницах ASP.NET
