BulletedList Web 伺服器控制項概觀

更新：2007 年 11 月

BulletedList 控制項可建立未排序或排序 (編號) 項目 (Item) 清單，這些項目分別以 HTML ul 或 ol 項目 (Element) 呈現。

這個主題包含：

• 案例

• 功能

• 背景

• HOW TO 和逐步解說主題

• 類別參考

案例

使用 BulletedList 控制項執行下列動作：

• 指定清單中的項目 (Item) 和項目符號 (Bullet) 或編號的外觀。

• 靜態地或將控制項繫結至資料，以定義清單項目。

• 回應使用者按一下項目的動作。

回到頁首

功能

使用 BulletedList 控制項時，您可以執行下列動作：

• 自訂項目符號和編號的外觀。

• 指定如何呈現清單中的每個項目，例如超連結、靜態文字或連結按鈕。

• 0% your edit Provide logic to perform application-specific tasks when a user clicks an item. Provide logic to perform application-specific tasks when a user clicks an item. 當使用者按一下項目時提供邏輯，依這套邏輯執行應用程式特有的工作。

回到頁首

背景

與 ListBox、DropDownList 和其他 ASP.NET 清單控制項一樣，BulletedList 控制項也衍生自 ListControl 類別。因此，使用 BulletedList 控制項就像使用這些控制項一樣。您可以定義 BulletedList 控制項的清單項目，方法是建立靜態項目，或將控制項繫結至資料來源。如果在設計階段就知道要顯示的項目，您可以在標記中將控制項的 Items 集合設定為一組個別項目。若要顯示動態項目，您可以在執行期間於程式碼中建立項目集合。如需詳細資訊，請參閱 HOW TO：將項目加入至 List Web 伺服器控制項 (Visual Studio)。

此外，也可以將控制項繫結至資料來源，該資料來源內含您要顯示的資訊。如需詳細資訊，請參閱 HOW TO：從資料來源填入 List Web 伺服器控制項 (Visual Studio)。

您可以組合靜態清單項目和資料繫結清單項目，方法是將控制項的 AppendDataBoundItems 屬性設定為 true。

定義 BulletedList 控制項的項目時，可以定義兩個屬性：Text 屬性和 Value 屬性。Text 屬性定義頁面所顯示的控制項。Value 屬性定義第二個值，此值不會顯示，但當使用者選取項目時，則會傳回此值。例如，您可以將員工姓名顯示為項目的文字，但使用員工 ID 做為值。當使用者按一下項目時，您可以直接讀取值。

安全性注意事項：
請不要將敏感資料 (例如客戶編號) 當做 BulletedList 控制項的值屬性。即使無法看見，頁面也會呈現個別項目的 Value 屬性設定，如此一來，使用者就能在頁面的來源中輕易看到這些設定。

自訂清單項目外觀

根據 BulletStyle 屬性的設定，BulletedList 控制項可以呈現項目符號或編號。若將控制項設定為呈現項目符號，則可從符合 HTML 標準項目符號樣式之預先定義的項目符號樣式欄位中選取，例如 Disc、Circle 和 Square 欄位所表示的樣式。

注意事項：
個別瀏覽器有多種呈現項目符號的方式，部分瀏覽器則不支援特定的項目符號樣式，例如 Disc 欄位。

您也可以指定顯示自訂影像，而非項目符號。

若將控制項設定為呈現編號，您可以從 HTML 標準編號選項中選取，例如 LowerAlpha、UpperAlpha、LowerRoman 和 UpperAlpha 欄位。藉由設定 FirstBulletNumber 屬性，也可以指定序列 (Sequence) 的起始號碼。

指定項目顯示模式

BulletedList 控制項可以將清單項目顯示成下列其中任何一項：

• 靜態文字：由控制項顯示，無法互動的文字。

• T:System.Web.UI.WebControls.HyperLink 控制項：使用者可以按一下連結移至另一個網頁。您必須提供目標 URL，做為個別項目的 Value 屬性。

• LinkButton控制項：使用者可以按一下個別項目，控制項就會執行回傳。

回應使用者選取

若設定 BulletedList 控制項將個別項目顯示成 LinkButton 控制項，控制項就會在使用者按一下項目時執行回傳。回傳會引發 BulletedList 控制項的 Click 事件，您可以在其中提供邏輯來執行應用程式特有的工作。事件會將按一下的項目之索引編號傳給您。如需詳細資訊，請參閱 HOW TO：回應使用者在 BulletedList Web 伺服器控制項中的按鍵 (Visual Studio)。

HOW TO 和逐步解說主題

• HOW TO：將 BulletedList Web 伺服器控制項加入至 Web Form 網頁 (Visual Studio)

• HOW TO：回應使用者在 BulletedList Web 伺服器控制項中的按鍵 (Visual Studio)

類別參考

下表列出 BulletedList 控制項的相關類別。

成員	描述
BulletedList	控制項的主要類別。
BulletedListDisplayMode	列舉型別，指定每個項目的顯示行為。
BulletedListEventArgs	事件資料，表示選取項目的索引。
BulletedListEventHandler	方法，處理 BulletedList 控制項的 Click 事件。
BulletStyle	列舉型別，指定可顯示的項目符號、數字或字母的類型。

回到頁首

請參閱

工作

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

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

HOW TO：設定清單 Web 伺服器控制項中的選取 (Visual Studio)