ListBox Web 伺服器控制項概觀

更新：2007 年 11 月

ListBox Web 伺服器控制項可讓使用者從預先定義的清單中選取一個或多個項目。

這個主題包含：

案例

如果想要一次顯示多個項目和讓使用者從預先定義的清單中選取一個或多個項目，請使用 ListBox Web 伺服器控制項。ListBox 控制項不同於 DropDownList 控制項，差別在於一次可以顯示多個項目，而且可以選擇讓使用者選取多個項目。

回到頁首

您可以使用 ListBox 控制項來執行下列動作：

回到頁首

ListBox 控制項通常用來同時顯示多個項目。您可以使用下列方法來控制清單外觀：

顯示的資料列數目。您可以將控制項設定為顯示特定數目的項目。如果控制項的項目個數超過此數，將會顯示垂直捲軸。
高度和寬度。您可使用像素來設定控制項的大小。在這種情況下，控制項會忽略已設定的資料列數，並顯示符合控制項高度的資料列數。某些瀏覽器不支援以像素來設定高度和寬度，並使用資料列計數設定。

藉由其他 Web 伺服器控制項，您可以使用樣式物件來指定控制項的外觀。如需詳細資訊，請參閱 ASP.NET Web 伺服器控制項和 CSS 樣式。

ListBox 控制項是一個或多個清單項目的容器 (Container)。每個清單項目都是 ListItem 型別的物件，並且具有自己的屬性。下表描述這些屬性。

屬性	描述
Text	指定清單中顯示的文字。
Value	包含與項目相關聯的數值。設定這項屬性讓您無需顯示特定項目便可將某個值與它產生關聯。例如，您可以將 Text 屬性設定為色彩名稱，並將 Value 屬性設定為其十六進位表示。
Selected	表示目前是否已選取該項目。

若要透過程式設計來使用項目，請使用 ListBox 控制項的 Items 集合。Items 是一個標準集合，可於其中加入項目物件、刪除項目或清除集合等。

您可在 ListBox 控制項的 SelectedItem 屬性中使用目前選取的項目。如果控制項設定為單一選取模式，這個屬性會傳回一個選取的項目。如果控制項設定為多重選取模式，您可以逐一查看整個 Items 集合並檢查每個項目的 Selected 屬性，以取得選取的項目。

通常使用者按一下清單中的單一項目便可選取該項目。若將 ListBox 控制項設為啟用多重選取，使用者就可以按住 CTRL 或 SHIFT 鍵，再同時按下項目便可多重選取。

您可使用 ListBox Web 伺服器控制項，列出可用於使用資料來源控制項的頁面之選項。ListBox 控制項的每個項目對應資料來源的某個項目，通常是個別資料錄。

此控制項顯示來源的某個欄位。您可以選擇將控制項繫結至第二個欄位以設定某個項目的值 (不會顯示)。

如同其他伺服器控制項一樣，您可以將任何控制項屬性 (例如控制項的色彩或大小) 繫結至資料。如需詳細資訊，請參閱 HOW TO：從資料來源填入 List Web 伺服器控制項 (Visual Studio)。

ListBox 控制項在使用者選取某項目時，會引發 SelectedIndexChanged 事件。預設狀況下，此事件不會使網頁張貼至伺服器，但您可以將 AutoPostBack 屬性設定為 true，讓控制項強制立即張貼。

注意事項：
瀏覽器必須支援 ECMAScript (JScript 或 JavaScript)，而且使用者的瀏覽器必須啟用指令碼功能，才能使用自動回傳功能。