Практическое руководство. Добавление элементов в серверные веб-элементы управления со списком

Обновлен: Ноябрь 2007

Информация в этом разделе применима к следующим серверным веб-элементам управления:

Элементы в серверные веб-элементы управления со списком можно добавить одним из трех указанных ниже способов.

Статически во время разработки.
Программно во время выполнения.
С использованием привязки данных. Дополнительные сведения см. в разделе Практическое руководство. Заполнение списочных серверных веб-элементов управления данными из источника данных.

При добавлении в список элемента необходимо указать до трех его возможных свойств. Эти свойства описаны в приведенной ниже таблице.

Свойство	Описание
Text	Указывает отображаемый в списке текст.
Value	Указывает значение, связанное с элементом, не неотображаемое. Например, свойству Text можно присвоить название химического элемента, а свойству Value — обозначение этого элемента.
Selected	Указывает, выбран ли элемент. В элементе управления CheckBoxList и элементе управления ListBox с поддержкой множественного выбора можно выбрать несколько элементов. В элементах управления DropDownList и RadioButtonList, а также в элементе управления ListBox с поддержкой одиночного выбора можно выбрать только один элемент. При попытке выбрать несколько элементов обозреватель определяет, какой из элементов будет отображаться выбранным. На элемент управления BulletedList этот параметр не влияет.

В режиме конструктора выделите элемент управления со списком, в который необходимо добавить элементы.

В окне «Свойства» нажмите в поле Items кнопку с многоточием ().

Откроется диалоговое окно Редактор коллекции ListItem.
Чтобы добавить новый элемент, нажмите кнопку Добавить.
Выделите новый элемент и введите в таблице свойств значения свойств Text, Value и Selected.
Повторите действия 2 и 3 для каждого добавляемого элемента, после чего нажмите кнопку ОК.

Создайте новый объект с типом ListItem и присвойте значения его свойствам Text и Value. Как правило, объект ListItem создается путем вызова метода Add.
Вызовите метод Add коллекции Items элемента управления и передайте методу новый объект.

В приведенном ниже примере кода показано, как добавить объекты ListItem в элемент управления ListBox, однако для всех остальных серверных веб-элементов управления со списком процедура аналогична.
```
Protected Sub Button1_Click(ByVal sender As System.Object, _
        ByVal e As System.EventArgs) Handles Button1.Click
    ListBox1.Items.Add(New ListItem("Carbon", "C"))
    ListBox1.Items.Add(New ListItem("Oxygen", "O"))
End Sub
```
```
Protected void Button1_Click (object sender, System.EventArgs e)
{
    ListBox1.Items.Add(new ListItem("Carbon", "C"));
    ListBox1.Items.Add(new ListItem("Oxygen", "O"));
}
```

См. также