4.5.10 Элемент управления BulletedList (Маркированный список)

Серверный элемент управления BulletedList в ASP.NET 2.0, свойства DisplayMode и BulletStyle

Элемент управления BulletedList (Маркированный список) предназначен для отображения динамически изменяемых списков на странице. Обычно при этом информация, которую нужно отображать в виде списка, берется из базы данных. Поэтому при размещении этого элемента управления на странице в вашем распоряжении появляется мастер настройки подключения к базе данных, аналогичный мастерам, используемым при настройке элемента управления DropDownList (см. раздел 4.5.5). Конечно же, вы можете определить набор элементов, которые будут отображаться в виде списка, и программным образом или даже набрать их вручную (при помощи пункта Edit items в мастере). Однако, если вам нужен статический список, удобнее использовать обычный тег <UL> в коде HTML.

Надо сказать, что возможности элемента управления BulletedList не ограничиваются только показом маркированного списка. При помощи этого элемента вы можете также показывать:

• разные варианты нумерованных списков;
• определять разные символы для пометки элементов маркированного списка (правда, здесь необходимо отметить, что не все броузеры будут правильно отображать эти символы);
• использовать в качестве элементов списка элементы управления HyperLink (для возможности перехода по ссылке при щелчке пользователя по элементу);
• использовать в качестве элементов списка элементы управления LinkButton (для организации специальной реакции при щелчке пользователя по элементу).

Все эти возможности реализуются при помощи свойств элемента управления BulletedList:

• DisplayMode — определяет, какие именно элементы будут выводиться в качестве членов списка. В вашем распоряжении — три варианта значения этого свойства:
• Text — список будет состоять из обычных строк;
• HyperLink — для списка будут использоваться элементы управления HyperLink;
• LinkButton — для списка будут использоваться элементы управления LinkButton.
• BulletStyle — определяет, как именно будет помечаться каждый элемент списка. Возможных значений — множество, но принципиально возможно три варианта:
• использовать маркеры (предусмотрена возможность использования самых разных символов, например, значение circle определяет маркер в виде кружка, а значение square — маркер в виде квадрата);
• использовать числа или буквы (получится нумерованный список, при этом при помощи свойства FirstBulletNumber можно определить, с какой чифры или буквы будет начинаться нумерация);
• использовать пользовательские изображения (значение CustomImage). При этом определить, какое именно изображение будет выводиться в качестве маркера, можно при помощи свойства BulletImageURL.

Если вы используете в качестве элементов списка элемент управления LinkButton, то настраивать реакцию на щелчок пользователя необходимо при помощи события Click для самого элемента управления BulletedList. При этом проверить, по какому элементу списка щелкнул пользователь, можно при помощи параметров, передаваемых событийной процедуре (значению свойства Value для элемента управления LinkButton). Пример может выглядеть так:

    Sub ItemsBulletedList_Click(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.BulletedListEventArgs)

        Select Case (e.Index)

            Case 0

                Message.Text = "Вы нажали на элемент списка 1"

            Case 1

                Message.Text = "Вы нажали на элемент списка 2"

            Case 2

                Message.Text = "Вы нажали на элемент списка 3"

            Case Else

                Throw New Exception("на что же вы нажали?")

        End Select

    End Sub

Получить учебные материалы по этому курсу