Repeater 控制項
Repeater 控制項是容器控制項,可讓您利用網頁上任何可使用的資料建立自訂清單。Repeater 控制項沒有自己的內建呈現方式,這表示您必須建立範本以提供 Repeater 控制項的版面配置。網頁於執行時,Repeater 控制項會重複資料來源中的記錄,並且為每筆記錄呈現一個項目。
由於 Repeater 控制項沒有預設外觀,因此您可以利用它建立各種清單,包括下列項目:
資料表版面配置
以逗號分隔的清單 (例如 a, b, c, d 等)
XML 格式化清單
新增 Repeater 控制項至網頁
- 將 Repeater 控制項從 [工具箱] 工作窗格拖曳至網頁。
在新增 Repeater 控制項後,您可為控制項指定資料來源。
將 Repeater 控制項繫結至資料來源
在 [設計] 檢視中,以滑鼠右鍵按一下 Repeater 控制項,再按 [顯示通用控制項工作]。
在 [ DropDownList 工作] 功能表上,按一下 [選擇資料來源]。
在 [資料來源組態精靈] 中,選擇 Repeater 控制項的來源。如需詳細資訊,請參閱使用資料繫結控制項,設定資料來源。
若要使用 Repeater 控制項,您可以建立用以定義控制項內容版面配置的範本。範本可以包含標記和控制項的任何組合。如果未定義任何範本或是沒有範本包含元素,則於應用程式執行時,控制項不會出現在網頁上。
新增 Repeater 控制項的建立範本
在 [程式碼] 檢視中,將插入點置於 <asp:Repeater></asp:Repeater> 標籤內。
按小於 (<) 鍵叫用程式碼完成下拉式清單。
按一下想要建立的範本。
為範本鍵入適當的 HTML。如需範本定義的範例,請參閱 MSDN Library 的 How to:將 Repeater Web 伺服器控制項加入至 Web Form 網頁。
下列清單說明 Repeater 控制項所支援的 Repeater 範本。
「ItemTemplate」包含呈現一次資料來源中每個資料項目的 HTML 元素及控制項。
「AlternatingItemTemplate」包含呈現一次資料來源中每個其他資料項目的 HTML 元素及控制項。通常,此範本會用以為替代項目建立不同的外觀,例如與 ItemTemplate 中所指定之色彩不同的背景色彩。
「HeaderTemplate 和 FooterTemplate」包含分別要在清單開頭與結尾呈現的文字和控制項。
「SeparatorTemplate」包含要呈現在每一項目間的元素。常見的範例是一空白行 (使用 HR 元素)。
如需有關使用 [Repeater] 控制項的其他資訊,請參閱 MSDN Library 的 Repeater 網頁伺服器控制項概觀。