Общие сведения о серверном веб-элементе управления BulletedList
Обновлен: Ноябрь 2007
Элемент управления BulletedList создает неупорядоченный или упорядоченный (нумерованный) список элементов, которые отображаются в виде элементов HTML ul или ol, соответственно.
В этом разделе рассматриваются следующие темы:
Сценарии
Функциональные возможности
Базовые сведения
Практические и пошаговые руководства
Ссылки на классы
Сценарии
Используйте элемент управления BulletedList для выполнения следующих действий:
Указание внешнего вида элементов и маркеров или номеров в списке.
Определение элементов списка как статических или в качестве элементов управления, привязанных к данным.
Отклик на щелчки элементов пользователем.
К началу
Функциональные возможности
При помощи элемента управления BulletedList можно выполнять следующие действия:
Настраивать внешний вид маркеров и номеров.
Указывать, в каком виде должен отображаться элемент списка: в виде гиперссылки, статического текста или кнопки-ссылки.
Предоставлять логику для выполнения присущих данному приложению задач, когда пользователь щелкает элемент.
К началу
Базовые сведения
Элемент управления BulletedList является производным от того же класса ListControl, что и ListBox, DropDownList, и другие элементы управления «Список» ASP.NET. Следовательно, элемент управления BulletedList используется так же, как и эти элементы. Можно определить элементы списка для элемента управления BulletedList либо создав статические элементы, либо связав элемент управления с источником данных. Если во время разработки уже известно, какие элементы необходимо отображать, то можно задать для коллекции элементов Items набор отдельных элементов в разметке. Если отображаемые элементы — динамические, то можно создать коллекцию элементов в коде во время выполнения. Дополнительные сведения см. в разделе Практическое руководство. Добавление элементов в серверные веб-элементы управления со списком.
Также можно связать элемент управления с источником данных, содержащим информацию, которую необходимо отобразить. Дополнительные сведения см. в разделе Практическое руководство. Заполнение списочных серверных веб-элементов управления данными из источника данных.
Можно объединять статические и связанные с данными элементы списка, присвоив свойству элемента управления AppendDataBoundItems значение true.
При определении элементов для элемента управления BulletedList, определяются два свойства: Text и Value. Свойство Text определяет, что именно элемент управления отображает на странице. Свойство Value определяет второе значение, которое не отображается, но, при необходимости, может быть возвращено, когда пользователь щелкает элемент. Например, можно отображать имя сотрудника, как текст элемента, а идентификатор сотрудника использовать, как значение. Когда пользователи щелкают элемент, то значение можно считать непосредственно.
.gif "Примечание о безопасности") Примечание о безопасности. |
|---|
Не следует использовать конфиденциальные данные, такие как номера покупателей, в качестве значений свойства элемента управления BulletedList. Даже не будучи видимыми, параметры свойства Value отдельных элементов передаются на страницу, где легко могут быть считаны пользователями в исходном коде страницы. |
Настройка внешнего вида элемента списка
Элемент управления BulletedList может отображать либо маркеры либо номера, в зависимости от значения свойства BulletStyle. Если элемент управления настроен на отображение маркеров, то из предопределенного стиля маркера можно выбрать поля, соответствующие стандартным стилям маркера HTML, такие как: Disc, Circle и Square.
.gif "Примечание") Примечание. |
|---|
Разные обозреватели по-разному отображают маркеры, а некоторые обозреватели не поддерживают определенные стили маркеров, такие как поле Disc. |
Также можно указать настраиваемое изображение, которое будет отображаться вместо маркера.
Если элемент управления настроен на отображение номеров, из стандартных параметров нумерации HTML можно выбрать такие поля, как LowerAlpha, UpperAlpha, LowerRoman и UpperAlpha. Заданием свойству FirstBulletNumber значения также можно указать начальный номер последовательности.
Задание режима отображения элемента
Элемент управления BulletedList может отображать элементы списка любым из следующих способов:
Статический текст: текст, отображаемый элементом управления, не интерактивный.
Элементы управления T:System.Web.UI.WebControls.HyperLink: пользователь может щелкать ссылки, чтобы перейти на другую страницу. Необходимо задать целевой URL-адрес, как свойство Value отдельного элемента.
Элементы управленияLinkButton: этот элемент управления выполняет обратную передачу при щелчке отдельных элементов.
Отклик на выбор пользователя
Если элемент управления BulletedList настроен на отображение отдельных элементов, как LinkButton, то он выполняет обратную передачу при щелчке элемента. Обратная передача вызывает событие Click элемента управления BulletedList, которому можно задать логику для выполнения характерных для приложения задач. Событие передает номер индекса элемента, который был щелкнут. Дополнительные сведения см. в разделе Практическое руководство. Отклик на щелчок пользователя в серверном веб-элементе управления BulletedList.
Практические и пошаговые руководства
Ссылки на классы
В следующей таблице перечислены классы, связанные с элементом управления BulletedList.
Член |
Описание |
|---|---|
Основной класс элемента управления. |
|
Перечисление, определяющее способ отображения каждого элемента. |
|
Данные события, которые указывают индекс выбранного элемента. |
|
Метод, обрабатывающий событие Click элемента управления BulletedList. |
|
Перечисление, определяющее типы маркеров, номеров или букв, которые могут отображаться. |
К началу
См. также
Задачи
Практическое руководство. Добавление элементов в серверные веб-элементы управления со списком
Практическое руководство. Выбор элементов в серверных веб-элементах управления "Список"