Общие сведения об элементе управления DataRepeater (Visual Studio)

Статья
11/05/2008

Обновлен: Июль 2008

Элемент управления пакетов Visual Basic Power Packs DataRepeater является прокручиваемым контейнером для элементов управления, отображающих повторяющиеся данные, например строки таблицы базы данных. Если требуется дополнительный контроль над размещением данных, этот элемент можно использовать в качестве альтернативы элемента управления DataGridView. "Дублирование" DataRepeater группы связанных элементов управления путем создания нескольких экземпляров в области прокрутки. Это позволяет пользователям видеть несколько записей в одно и то же время.

Общие сведения

На этапе разработки элемент управления DataRepeater состоит из двух подразделов. Внешний подраздел является окном просмотра, в котором просматриваемые данные будут отражены во время выполнения. Внутренний (верхний) подраздел, называемый шаблон элемента, в котором располагаются элементы управления, которые будут изображены во время выполнения; обычно один элемент управления соответствует одному полю в источнике данных. Свойства и элементы управления в шаблоне элемента включены в свойство ItemTemplate.

Во время выполнения, ItemTemplate копируется в виртуальный объект DataRepeaterItem, который используется для отображения данных при просмотре каждой записи. Можно настроить отображение индивидуальных записей в событии DrawItem, например, выделение поля на основе содержащегося в нем значении. Дополнительные сведения см. в разделе Практическое руководство. Изменение внешнего вида элемента управления DataRepeater (Visual Studio).

Наиболее общее использование элемента управления DataRepeater — отображение данных из таблицы базы данных или других связанных источников данных. В дополнение к объектам данных ADO.NET, элемент управления DataRepeater можно привязать к любому классу (включая массивы), который реализует интерфейс IList, любому классу, который реализует интерфейс IListSource, любому классу, который реализует интерфейс IBindingList или любому классу, который реализует интерфейс IBindingListView.

Привязка данных

Обычно, привязка данных выполняется при помощи перетаскивания полей из окна Источники данных в элемент управления DataRepeater. Дополнительные сведения см. в разделе Пошаговое руководство. Отображение связанных данных в элементе управления DataRepeater (Visual Studio).

При работе с большими объемами данных можно задать для свойства VirtualMode значение True, чтобы отобразить подмножество доступных данных. Виртуальный режим требует реализации кэша данных, из которого заполняется DataRepeater, следует также контролировать все взаимодействия с кэшем данным во время выполнения. Дополнительные сведения см. в разделе Виртуальные режим в элементе управления DataRepeater (Visual Studio).

Можно также отобразить несвязанные элементы управления в элементе управления DataRepeater. Например, можно отобразить рисунок, который повторяется на каждом элементе. Дополнительные сведения см. в разделе Пошаговое руководство. Отображение несвязанных данных в элементе управления DataRepeater (Visual Studio).

События

Наиболее важными для элемента управления DataRepeater являются DrawItem событие, возникающее при появлении нового элемента в области просмотра и событие CurrentItemIndexChanged, возникающее при выделении элемента. Можно использовать событие DrawItem для изменения внешнего вида элемента. Например, можно выделить отрицательные значения. Используйте событие CurrentItemIndexChanged для обращения к значениям элементов управления при выделении элементов.

Элемент управления DataRepeater предоставляет все стандартные события элементов управления в редакторе кода. Однако, некоторые события не следует использовать. События клавиатуры и мыши, такие как KeyDown, Click и MouseDown не будут возникать во время выполнения, так как элемент управления DataRepeater никогда не фокусируется сам на себе.

Элемент DataRepeaterItem не предоставляет события на этапе разработки, так как он создается только во время выполнения. Если необходимо обрабатывать события клавиатуры и мыши, можно добавить элемент управления Panel в шаблон ItemTemplate на этапе разработки и затем обрабатывать события для Panel. Дополнительные сведения см. в разделе Устранение неполадок при использовании элемента управления DataRepeater (Visual Studio).

Настройки

Есть много способов настроить поведение и внешний вид элемента управления DataRepeater, как на этапе разработки, так и в процессе выполнения. Можно настроить свойства для изменения цветов, скрытия или изменения заголовков элементов, изменения ориентации с вертикальной на горизонтальную и многое другое. Дополнительные сведения см. в разделах Практическое руководство. Изменение внешнего вида элемента управления DataRepeater (Visual Studio), Пошаговое руководство. Отображение заголовков элементов в элементе управления DataRepeater (Visual Studio) и Практическое руководство. Изменение структуры элемента управления DataRepeater (Visual Studio).

Обратите внимание, что некоторые свойства применяются к самому элементу управления DataRepeater, тогда как другие свойства применяются только к ItemTemplate. Убедитесь, что используется правильный подраздел выбранного элемента управления перед настройкой свойств. Дополнительные сведения см. в разделе Практическое руководство. Изменение внешнего вида элемента управления DataRepeater (Visual Studio).

Другие настройки включают контроль за возможностью добавления или удаления записей, добавление возможностей поиска и отображают связанные данные в основном и подробном представлениях. Дополнительные сведения см. в разделах Пошаговое руководство. Запрещение возможности добавления и удаления элементов DataRepeater (Visual Studio), Практическое руководство. Поиск данных в элементе управления DataRepeater (Visual Studio) и Практическое руководство. Создание главного и подчиненного представлений данных с использованием двух элементов управления DataRepeater (Visual Studio).