DataRepeater 控制項簡介 (Visual Studio)

發行項
06/10/2015

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

概觀

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

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

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

資料繫結

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

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

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

事件

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

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

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