共用方式為


DataRepeater 控制項簡介 (Visual Studio)

更新: 2008 年 7 月

Visual Basic Power Packs 中的 DataRepeater 控制項是一種可捲動容器,適合顯示重複資料 (如資料庫資料表中的資料列) 的控制項使用。當您需要進一步控制資料的配置時,可以使用它來替代 DataGridView 控制項。DataRepeater 藉由在捲動檢視中建立多個執行個體,「重複」一組相關的控制項,這樣有助於使用者同時檢視多個資料錄。

概觀

在設計階段,DataRepeater 控制項由兩個區段組成。外部區段為「檢視區」(Viewport),是捲動資料在執行階段的顯示位置。內部 (上方) 區段稱為「項目樣板」(Item Template),只要是置入這個位置的控制項,都會在執行階段重複出現,通常一個控制項會對應一個資料來源欄位。項目樣板中的屬性和控制項會封裝在 ItemTemplate 屬性中。

在執行階段,ItemTemplate 會被複製到虛擬 DataRepeaterItem 物件,並使用這個物件在每一筆被捲動到檢視處的資料錄中顯示資料。您可以在 DrawItem 事件中自訂個別資料錄的顯示,例如依照欄位值反白顯示欄位。如需詳細資訊,請參閱 HOW TO:變更 DataRepeater 控制項的外觀 (Visual Studio)

DataRepeater 控制項最常見的用途就是顯示資料庫資料表或其他繫結資料來源的資料。除了 ADO.NET 資料物件之外,DataRepeater 控制項還可以繫結到任何實作 IList 介面 (包括陣列) 的類別 (Class)、任何實作 IListSource 介面的類別、任何實作 IBindingList 介面的類別或任何實作 IBindingListView 介面的類別。

資料繫結

完成資料繫結的一般做法是將欄位從 [資料來源] 視窗拖曳到 DataRepeater 控制項上。如需詳細資訊,請參閱 HOW TO:在 DataRepeater 控制項中顯示繫結資料 (Visual Studio)

在處理大量資料時,您可以將 VirtualMode 屬性設定為 True,以顯示可用的資料子集。虛擬模式會要求實作填入 (Populate) DataRepeater 的資料快取,而您必須在執行階段控制所有與資料快取的互動。如需詳細資訊,請參閱 DataRepeater 控制項中的虛擬模式 (Visual Studio)

您也可以在 DataRepeater 控制項上顯示未繫結控制項,例如顯示重複出現在每個項目上的影像。如需詳細資訊,請參閱 HOW TO:在 DataRepeater 控制項中顯示未繫結資料 (Visual Studio)

事件

DataRepeater 控制項最重要的事件是 DrawItem 事件 (會在新的項目被捲動到檢視處時引發) 以及 CurrentItemIndexChanged 事件 (會在項目被選取時引發)。您可以使用 DrawItem 事件變更項目的外觀,例如將負值反白顯示。當項目被選取時,CurrentItemIndexChanged 事件可以用來存取控制項的值。

DataRepeater 控制項會在程式碼編輯器中公開 (Expose) 所有的標準控制項事件,不過,不應該使用某些事件。鍵盤和滑鼠事件如 KeyDown、Click、MouseDown 等在執行階段並不會被引發,因為 DataRepeater 控制項本身永遠不會獲得焦點 (Focus)。

DataRepeaterItem 並不會在設計階段公開事件,因為它只有在執行階段才會產生。如果要處理鍵盤和滑鼠事件,您可以在設計階段將 Panel 控制項加入至 ItemTemplate,然後處理 Panel 的事件。如需詳細資訊,請參閱 疑難排解 DataRepeater 控制項 (Visual Studio)

自訂

在執行階段以及設計階段中,有許多種方式可以自訂 DataRepeater 控制項的外觀和行為。您可以將屬性設定為變更色彩、隱藏或修改項目標題、將方向從縱向變成橫向等等。如需詳細資訊,請參閱 HOW TO:變更 DataRepeater 控制項的外觀 (Visual Studio)HOW TO:在 DataRepeater 控制項中顯示項目標題 (Visual Studio)HOW TO:變更 DataRepeater 控制項的配置 (Visual Studio)

請注意,有些屬性適用於 DataRepeater 控制項本身,而有些屬性卻僅適用於 ItemTemplate,因此,在設定屬性前,請務必確定選取了正確的控制項區段。如需詳細資訊,請參閱 HOW TO:變更 DataRepeater 控制項的外觀 (Visual Studio)

其他自訂包括控制加入或刪除資料錄功能、加入搜尋功能,以及以主從式格式顯示相關資料。如需詳細資訊,請參閱 HOW TO:停用加入和刪除 DataRepeater 項目 (Visual Studio)HOW TO:搜尋 DataRepeater 控制項中的資料 (Visual Studio)HOW TO:使用兩個 DataRepeater 控制項建立主從式表單 (Visual Studio)

請參閱

工作

逐步解說:在 DataRepeater 控制項中顯示資料 (Visual Studio)

疑難排解 DataRepeater 控制項 (Visual Studio)

其他資源

DataRepeater 控制項

變更記錄

日期

記錄

原因

2008 年 7 月

加入主題。

SP1 功能變更。