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- Наследование
- Наследование
- Реализации
Примеры
Проект веб-сайта Visual Studio с исходным кодом доступен в этом разделе: Скачивание.
В следующем примере кода показано, как создать CheckBoxList элемент управления на веб-странице.
Примечание
В следующем примере кода используется модель кода с одним файлом и может работать неправильно при копировании непосредственно в файл кода программной части. Этот пример кода необходимо скопировать в пустой текстовый файл с расширением ASPX. Дополнительные сведения о модели кода веб-формы см. в разделе модель кода страницы ASP.NET Web Forms.
<%@ 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 Controls and Accessibility.
Декларативный синтаксис
<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 |
Получает значение, указывающее, должен ли элемент управления устанавливать для атрибута |
| SupportsDisabledAttribute |
Получает значение, указывающее, должен ли элемент управления устанавливать для атрибута |
| TabIndex |
Возвращает или задает индекс перехода по клавише Tab для серверного веб-элемента управления. (Унаследовано от 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) |
Вызывается после добавления дочернего элемента управления в коллекцию 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() |
Создает объект стиля, который внутренне используется элементом управления 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) |
Выполняет поиск серверного элемента управления с заданным параметром |
| FindControl(String, Int32) |
Выполняет поиск текущего контейнера именования для серверного элемента управления с заданным ИД и смещением пути. Метод FindControl(String, Int32) всегда возвращает объект CheckBoxList. |
| 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) |
Вызывается после удаления дочернего элемента управления из коллекции Controls объекта Control. (Унаследовано от Control) |
| Render(HtmlTextWriter) |
Отображает объект CheckBoxList на стороне клиента. |
| RenderBeginTag(HtmlTextWriter) |
Выводит открывающий HTML-тег элемента управления в указанное средство записи. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl) |
| RenderChildren(HtmlTextWriter) |
Выводит содержимое дочерних элементов серверного элемента управления в предоставленный объект HtmlTextWriter, который записывает это содержимое для подготовки к просмотру на клиенте. (Унаследовано от Control) |
| RenderContents(HtmlTextWriter) |
Прорисовывает элементы в элементе управления ListControl. (Унаследовано от ListControl) |
| RenderControl(HtmlTextWriter) |
Выводит содержимое серверного элемента управления в указанный объект HtmlTextWriter и сохраняет сведения о трассировке элемента управления, если трассировка включена. (Унаследовано от Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Выводит серверный элемент управления в указанный объект HtmlTextWriter, используя указанный объект ControlAdapter. (Унаследовано от Control) |
| RenderEndTag(HtmlTextWriter) |
Отображает закрывающий HTML-тег элемента управления в указанное средство записи. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl) |
| RenderItem(ListItemType, Int32, RepeatInfo, HtmlTextWriter) |
Прорисовывает элемент списка в элементе управления CheckBoxList. |
| 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) |
| 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 |
Получает число элементов в элементе управления "Список". |
Методы расширения
| EnablePersistedSelection(BaseDataBoundControl) |
Устаревшие..
Включает возможность сохранения в элементах управления данными, поддерживающих выделение и разбиение по страницам. |
| FindDataSourceControl(Control) |
Возвращает источник данных, связанный с элементом управления данными, для заданного элемента управления. |
| FindFieldTemplate(Control, String) |
Возвращает шаблон поля для заданного столбца в контейнере именования заданного элемента управления. |
| FindMetaTable(Control) |
Возвращает объект метатаблицы для контейнерного элемента управления данными. |
| GetDefaultValues(INamingContainer) |
Получает коллекцию значений по умолчанию для заданного элемента управления данными. |
| GetMetaTable(INamingContainer) |
Получает метаданные таблицы для заданного элемента управления данными. |
| SetMetaTable(INamingContainer, MetaTable) |
Задает метаданные таблицы для заданного элемента управления данными. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Задает метаданные таблицы и преобразование значений по умолчанию для заданного элемента управления данными. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Задает метаданные таблицы и преобразование значений по умолчанию для заданного элемента управления данными. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Определяет, доступны ли метаданные таблицы. |
| EnableDynamicData(INamingContainer, Type) |
Включает поведение платформы динамических данных для указанного элемента управления данными. |
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Включает поведение платформы динамических данных для указанного элемента управления данными. |
| EnableDynamicData(INamingContainer, Type, Object) |
Включает поведение платформы динамических данных для указанного элемента управления данными. |
Применяется к
См. также раздел
- ListControl
- CheckBox
- Серверные веб-элементы управления CheckBox и CheckBoxList
- Защита стандартных элементов управления
- Практическое руководство. Защита от эксплойтов скриптов в веб-приложении путем применения кодировки HTML к строкам
- Общие сведения о проверке входных данных пользователя в веб-страницы ASP.NET
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе: https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по