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

更新：2007 年 11 月

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

• ListBox

• DropDownList

• CheckBoxList

• RadioButtonList

• BulletedList

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

• 在設計階段加入靜態項目。

• 以程式設計方式在執行階段加入項目。

• 使用資料繫結加入項目。如需詳細資訊，請參閱 HOW TO：從資料來源填入 List Web 伺服器控制項 (Visual Studio)。

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

屬性	說明
Text	指定顯示於清單中的文字。
Value	指定與項目相關聯但不會顯示的值。例如，您可將 Text 屬性設定為化學元素的名稱，並且將 Value 屬性設定為元素符號。
Selected	表示項目是否選取。在 CheckBoxList 控制項和多重選取 ListBox 控制項中，可以選取一個以上的項目。在 DropDownList 控制項、RadioButtonList 控制項和單一選取 ListBox 控制項中，一次只能選取一個項目。如果在這些控制項中設定一個以上的選取項目，瀏覽器則會決定將哪個項目呈現為已選取。在 BulletedList 控制項中，這項設定沒有效果。

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

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

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

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

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

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

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

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

1. 建立 ListItem 型別的新物件，並設定它的 Text 和 Value 屬性。一般而言，您會呼叫 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)