Repeater 控制項

Repeater 控制項是容器控制項,可讓您利用網頁上任何可使用的資料建立自訂清單。Repeater 控制項沒有自己的內建呈現方式,這表示您必須建立範本以提供 Repeater 控制項的版面配置。網頁於執行時,Repeater 控制項會重複資料來源中的記錄,並且為每筆記錄呈現一個項目。

由於 Repeater 控制項沒有預設外觀,因此您可以利用它建立各種清單,包括下列項目:

  • 資料表版面配置

  • 以逗號分隔的清單 (例如 a, b, c, d 等)

  • XML 格式化清單

新增 Repeater 控制項至網頁

  • 將 Repeater 控制項從 [工具箱] 工作窗格拖曳至網頁。

在新增 Repeater 控制項後,您可為控制項指定資料來源。

將 Repeater 控制項繫結至資料來源

  1. 在 [設計] 檢視中,以滑鼠右鍵按一下 Repeater 控制項,再按 [顯示通用控制項工作]。

  2. 在 [ DropDownList 工作] 功能表上,按一下 [選擇資料來源]。

  3. 在 [資料來源組態精靈] 中,選擇 Repeater 控制項的來源。如需詳細資訊,請參閱使用資料繫結控制項,設定資料來源

若要使用 Repeater 控制項,您可以建立用以定義控制項內容版面配置的範本。範本可以包含標記和控制項的任何組合。如果未定義任何範本或是沒有範本包含元素,則於應用程式執行時,控制項不會出現在網頁上。

新增 Repeater 控制項的建立範本

  1. 在 [程式碼] 檢視中,將插入點置於 <asp:Repeater></asp:Repeater> 標籤內。

  2. 按小於 (<) 鍵叫用程式碼完成下拉式清單。

  3. 按一下想要建立的範本。

  4. 為範本鍵入適當的 HTML。如需範本定義的範例,請參閱 MSDN Library 的 How to:將 Repeater Web 伺服器控制項加入至 Web Form 網頁

下列清單說明 Repeater 控制項所支援的 Repeater 範本。

  • 「ItemTemplate」包含呈現一次資料來源中每個資料項目的 HTML 元素及控制項。

  • 「AlternatingItemTemplate」包含呈現一次資料來源中每個其他資料項目的 HTML 元素及控制項。通常,此範本會用以為替代項目建立不同的外觀,例如與 ItemTemplate 中所指定之色彩不同的背景色彩。

  • 「HeaderTemplate 和 FooterTemplate」包含分別要在清單開頭與結尾呈現的文字和控制項。

  • 「SeparatorTemplate」包含要呈現在每一項目間的元素。常見的範例是一空白行 (使用 HR 元素)。

如需有關使用 [Repeater] 控制項的其他資訊,請參閱 MSDN Library 的 Repeater 網頁伺服器控制項概觀

請參閱

概念

ASP.NET 概觀

DataList 控制項

DetailsView 控制項

FormView 控制項

GridView 控制項