通过

如何：在列表 Web 服务器控件中添加项 (Visual Studio)

更新：2007 年 11 月

本主题中的信息适用于以下 Web 服务器控件：

可以使用以下三种方法向列表 Web 服务器控件添加项：

添加列表项时，最多可以为该项指定三个可能的属性。下表描述了这些属性。

属性

说明

Text

指定列表中显示的文本。

Value

指定一个与项关联但不显示的值。例如，可以将 Text 属性设置为化学元素的名称，并将 Value 属性设置为该元素的符号。

Selected

指示是否选择此项。在 CheckBoxList 控件和多重选择 ListBox 控件中，可以选择多个项。在 DropDownList 控件、RadioButtonList 控件和单项选择 ListBox 控件中，一次只能选择一个项。如果您在这些控件中设置多个选定的项，则浏览器将确定哪一项呈现选定状态。在 BulletedList 控件中，此设置不起作用。

在设计时添加静态项

  1. 在“设计”视图中，选择要向其中添加项的列表控件。

    在“属性”窗口中，单击 Items 框中的省略号按钮 (VisualStudioEllipsesButton 屏幕快照)。

    出现**“ListItem 集合编辑器”**对话框。

  2. 单击**“添加”**添加新项。

  3. 选择此新项，然后在属性网格中为它的**“Text”、“Value”和“Selected”**属性输入值。

  4. 对要添加的每个项重复步骤 2 和步骤 3，然后单击**“确定”**。

以编程方式添加项

  1. 创建 ListItem 类型的新对象，设置其 Text 属性和 Value 属性。通常是通过调用 Add 方法来创建新的 ListItem。

  2. 调用控件的 Items 集合的 Add 方法，并将新对象传递给它。

    下面的代码示例演示如何向 ListBox 控件添加 ListItem 对象，但是，对于所有列表 Web 服务器控件，添加过程均相同。

    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"));
}

请参见

任务

如何：根据数据源来填充列表 Web 服务器控件 (Visual Studio)