DataRepeater コントロールの概要 (Visual Studio)Introduction to the DataRepeater Control (Visual Studio)

Visual Basic Power Packs の DataRepeater コントロールは、データベース テーブルの行などの繰り返されるデータを表示するコントロールの、スクロール可能なコンテナーです。The Visual Basic Power Packs DataRepeater control is a scrollable container for controls that display repeated data, for example, rows in a database table. データのレイアウトを詳細に制御する必要がある場合は、 DataGridView コントロールの代わりにこのコントロールを使用できます。It can be used as an alternative to the DataGridView control when you need more control over the layout of the data. DataRepeaterスクロール ビューで複数のインスタンスを作成して関連するコントロールのグループを「繰り返し」。The DataRepeater "repeats" a group of related controls by creating multiple instances in a scrolling view. これにより、ユーザーが同時に複数のレコードを表示できます。This enables users to view several records at the same time.


デザイン時に、DataRepeaterコントロールは、2 つのセクションで構成されています。At design time, the DataRepeater control consists of two sections. 外部のセクションでは、ビューポート、スクロール可能なデータが実行時に表示されます。The outer section is the viewport, where the scrolling data will be displayed at run time. 内部の (上部) セクションと呼ばれる、項目テンプレートが実行時、データ ソースのフィールドごとに通常 1 つのコントロールに繰り返されるコントロールを配置します。The inner (top) section, known as the item template, is where you position controls that will be repeated at run time, typically one control for each field in the data source. プロパティと項目テンプレート内のコントロールにカプセル化、ItemTemplateプロパティ。The properties and controls in the item template are encapsulated in the ItemTemplate property.

実行時に、ItemTemplateバーチャル マシンにコピーされますDataRepeaterItem各レコードをスクロールして表示するときにデータを表示するために使用するオブジェクト。At run time, the ItemTemplate is copied to a virtual DataRepeaterItem object that is used to display the data when each record is scrolled into view. 内の個々 のレコードの表示をカスタマイズすることができます、DrawItemイベント、たとえば、それに含まれる値に基づくフィールドを強調表示します。You can customize the display of individual records in the DrawItem event, for example, highlighting a field based on the value that it contains. 詳細については、次を参照してください。方法: DataRepeater コントロールの外観を変更します。For more information, see How to: Change the Appearance of a DataRepeater Control.

最も一般的な用途、DataRepeaterコントロールは、データベース テーブルまたはその他のバインドされたデータ ソースからデータを表示します。The most common use for a DataRepeater control is to display data from a database table or other bound data source. ほかにADO.NETADO.NETデータ オブジェクト、DataRepeaterコントロールを実装するクラスにバインドできます、IListインターフェイス (配列を含む)、実装するクラス、IListSourceインターフェイスを実装するクラス、 IBindingListインターフェイス、または実装するクラス、IBindingListViewインターフェイス。In addition to ADO.NETADO.NET data objects, the DataRepeater control can bind to any class that implements the IList interface (including arrays), any class that implements the IListSource interface, any class that implements the IBindingList interface, or any class that implements the IBindingListView interface.

データ バインディングData Binding

通常からフィールドをドラッグしてデータ バインディングを行う、データ ソースウィンドウ、DataRepeaterコントロール。Typically, you accomplish data binding by dragging fields from the Data Sources window onto the DataRepeater control. 詳細については、次を参照してください。方法: DataRepeater コントロールにバインドされているデータを表示します。For more information, see How to: Display Bound Data in a DataRepeater Control.

設定することが大量のデータを操作するとき、VirtualModeプロパティをTrue使用可能なデータのサブセットを表示します。When working with large amounts of data, you can set the VirtualMode property to True to display a subset of the available data. 仮想モードには、元のデータ キャッシュの実装が必要です、DataRepeaterの値が設定され、実行時にデータ キャッシュのすべての通信を制御する必要があります。Virtual mode requires the implementation of a data cache from which the DataRepeater is populated, and you must control all interactions with the data cache at run time. 詳細については、次を参照してください。 DataRepeater コントロールでの仮想モードします。For more information, see Virtual Mode in the DataRepeater Control.

バインドされていないコントロールを表示することも、DataRepeaterコントロール。You can also display unbound controls on a DataRepeater control. たとえば、各項目のイメージを繰り返すを表示できます。For example, you can display an image that is repeated on each item. 詳細については、次を参照してください。方法: DataRepeater コントロールにバインドされていないコントロールを表示します。For more information, see How to: Display Unbound Controls in a DataRepeater Control.


最も重要なイベント、DataRepeaterコントロールは、DrawItemビューに新しい項目がスクロールされたときに発生するイベントとCurrentItemIndexChangedイベントで、項目が選択されている場合に発生します。The most important events for the DataRepeater control are the DrawItem event, which is raised when new items are scrolled into view, and the CurrentItemIndexChanged event, which is raised when an item is selected. 使用することができます、DrawItem項目の外観を変更するイベントです。You can use the DrawItem event to change the appearance of the item. たとえば、負の値を強調表示することができます。For example, you can highlight negative values. 使用して、CurrentItemIndexChanged項目が選択されているときにコントロールの値にアクセスするイベントです。Use the CurrentItemIndexChanged event to access the values of controls when an item is selected.

DataRepeaterコントロールは、コード エディターですべて標準コントロールのイベントを公開します。The DataRepeater control exposes all the standard control events in the Code Editor. ただし、一部のイベントは使用されません。However, some of the events should not be used. キーボードし、マウス イベントなどKeyDownClickMouseDownために、実行時に発生しませんが、DataRepeaterコントロール自体にフォーカスがあることはありません。Keyboard and mouse events such as KeyDown, Click, and MouseDown will not be raised at run time because the DataRepeater control itself never has focus.

DataRepeaterItem実行時にのみ作成されるので、デザイン時にイベントを公開しないしません。The DataRepeaterItem does not expose events at design time because it is created only at run time. 追加できますキーボードとマウスのイベントを処理するかどうか、Panelへの制御、ItemTemplateでのイベントを処理し、デザイン時と、Panelします。If you want to handle keyboard and mouse events, you can add a Panel control to the ItemTemplate at design time and then handle the events for the Panel. 詳細については、次を参照してください。 DataRepeater コントロールのトラブルシューティングします。For more information, see Troubleshooting the DataRepeater Control.


動作と外観をカスタマイズする方法はたくさんあります、DataRepeater実行時およびデザイン時の両方を制御します。There are many ways to customize the appearance and behavior of the DataRepeater control, both at run time and at design time. 色を変更、非表示または変更項目ヘッダー、方向から水平方向、垂直な変更は、プロパティを設定できます。Properties can be set to change colors, hide or modify the item headers, change the orientation from vertical to horizontal, and much more. 詳細については、次を参照してください方法: DataRepeater コントロールの外観を変更方法: DataRepeater コントロールに項目ヘッダーを表示、と方法: レイアウトの変更、。DataRepeater コントロールします。For more information, see How to: Change the Appearance of a DataRepeater Control, How to: Display Item Headers in a DataRepeater Control, and How to: Change the Layout of a DataRepeater Control.

一部のプロパティに適用されます、DataRepeaterコントロール自体にのみ適用されるものは、 ItemTemplateNote that some properties apply to the DataRepeater control itself whereas others apply only to the ItemTemplate. プロパティを設定する前に、コントロールの適切なセクションがあることを確認します。Make sure that you have the correct section of the control selected before you set properties. 詳細については、次を参照してください。方法: DataRepeater コントロールの外観を変更します。For more information, see How to: Change the Appearance of a DataRepeater Control.

その他のカスタマイズには、レコード追加または削除する機能を制御する、検索の機能の追加、およびマスター/詳細形式で関連データの表示が含まれます。Other customizations include controlling the ability to add or delete records, adding search capabilities, and displaying related data in a master and detail format. 詳細については、次を参照してくださいする方法: DataRepeater の項目の削除の追加を無効にすると方法: DataRepeater コントロールにデータを検索、と方法: 2 つを使用してマスター/詳細フォームを作成する。DataRepeater コントロール (Visual Studio)します。For more information, see How to: Disable Adding and Deleting DataRepeater Items, How to: Search Data in a DataRepeater Control, and How to: Create a Master/Detail Form by Using Two DataRepeater Controls (Visual Studio).

関連項目See Also

DataRepeater コントロールDataRepeater Control
チュートリアル: DataRepeater コントロールでのデータの表示Walkthrough: Displaying Data in a DataRepeater Control
DataRepeater コントロールのトラブルシューティングTroubleshooting the DataRepeater Control