HOW TO:將項目加入至 List Web 伺服器控制項 (Visual Studio)

更新:2007 年 11 月

本主題中的資訊適用於以下 Web 伺服器控制項:

您可以使用以下三個方法,將項目加入清單 Web 伺服器控制項中:

加入清單項目時,最多可以指定項目的三個可能屬性。下表說明這些屬性。

屬性

說明

Text

指定顯示於清單中的文字。

Value

指定與項目相關聯但不會顯示的值。例如,您可將 Text 屬性設定為化學元素的名稱,並且將 Value 屬性設定為元素符號。

Selected

表示項目是否選取。在 CheckBoxList 控制項和多重選取 ListBox 控制項中,可以選取一個以上的項目。在 DropDownList 控制項、RadioButtonList 控制項和單一選取 ListBox 控制項中,一次只能選取一個項目。如果在這些控制項中設定一個以上的選取項目,瀏覽器則會決定將哪個項目呈現為已選取。在 BulletedList 控制項中,這項設定沒有效果。

若要在設計階段加入靜態項目

  1. 在 [設計] 檢視中,選取您要加入項目的清單控制項。

    在 [屬性] 視窗中,按一下 [Items] 方塊中的省略按鈕 ()。

    [ListItem 集合編輯器] 對話方塊隨即出現。

  2. 按一下 [加入] 以加入新項目。

  3. 選取新項目,然後在屬性方格中,輸入它的 [Text]、[Value] 和 [Selected] 等屬性值。

  4. 針對每個要加入的項目,重複步驟 2 和步驟 3,然後按一下 [確定]。

若要以程式設計方式加入項目

  1. 建立 ListItem 型別的新物件,並設定它的 TextValue 屬性。一般而言,您會呼叫 Add 方法來建立新的 ListItem

  2. 呼叫控制項之 Items 集合的 Add 方法,並將新物件傳遞給它。

    下列程式碼範例說明如何將 ListItem 物件加入至 ListBox 控制項,但此程序對所有清單 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"));
    }
    

請參閱

工作

HOW TO:從資料來源填入 List Web 伺服器控制項 (Visual Studio)