DataGrid (архивировано)

Предупреждение

Этот документ был архивирован, и компонент недоступен в текущей версии набора средств сообщества Windows.

Хотя нет немедленных планов по переносу этого компонента непосредственно в 8.x, важно понимать следующее:

• WcT 7.x DataGrid по-прежнему используется вместе с компонентами WCT 8.x для существующих проектов.
• Элемент управления DataGrid не рекомендуется использовать в пользу альтернативных вариантов.

Для новой разработки рекомендуется использовать DataTable или WinUI.TableView компонент, который предлагает улучшенные функциональные возможности и активно поддерживается.

Если у вас есть конкретные требования, которым DataTable не удовлетворяет, рассмотрите возможность внести свой вклад в WCT Labs, где улучшения компонентов прототипируются и инкубируются.

Дополнительные сведения:

• Обсуждение DataTable в Labs
• Репозиторий GitHub сообщества инструментов
• Замечания и предложения по документации
• Проект сообщества WinUI.TableView

Исходная документация приведена ниже.

---

Элемент управления DataGrid предоставляет гибкий способ отображения коллекции данных в строках и столбцах.

Замечание

Элемент управления DataGrid не является частью элементов управления WinUI 3, доступных в Наборе средств сообщества Windows версии 8.0 и более поздних версий. Элемент управления доступен для приложений UWP и Uno Platform в Windows Community Toolkit версии 7.1.0.

Встроенные типы столбцов включают текстовый столбец, столбец флажка, столбец со списком и столбец шаблона для размещения пользовательского содержимого. Встроенный тип строки содержит раскрывающийся список, который можно использовать для отображения дополнительного содержимого под значениями ячейки.

Элемент управления DataGrid поддерживает общие параметры форматирования таблицы, такие как чередование фона строк и переднего плана, а также возможность отображать или скрывать заголовки, линии сетки и полосы прокрутки. Кроме того, элемент управления предоставляет несколько свойств стиля и шаблона, которые можно использовать для полного изменения внешнего вида элемента управления и его строк, столбцов, ячеек и заголовков строк или столбцов.

DataGrid имеет встроенную поддержку экранного диктора и сенсорного экранного диктора, чтобы помочь слепым пользователям легко перемещаться и взаимодействовать с элементом управления. Кроме того, элемент управления имеет встроенную поддержку расширенной навигации по клавиатуре по ячейкам, заголовкам, строкам и столбцам.

How-Tos

В следующих разделах руководства описаны дополнительные понятия и методы, которые можно использовать для создания функций управления DataGrid в приложениях:

• Добавление элемента управления DataGrid на страницу
• Настройка элемента управления DataGrid с помощью параметров стилизации и форматирования
• Параметры размера в элементе управления DataGrid
• Шаблоны навигации и выбора клавиатуры по умолчанию
• Отображение и настройка сведений о строке
• Настройка автоматически созданных столбцов в элементе управления DataGrid
• Группировка, сортировка и фильтрация данных с помощью LINQ и элемента управления DataGrid
• Редактирование и проверка входных данных в элементе управления DataGrid

Пример проекта

Ниже приведен пример исходного кода DataGrid.

Если у вас установлено приложение WinUI 2 Gallery, вы можете использовать его для просмотра DataGrid в действии.

• Скачайте приложение WinUI 2 Gallery из Microsoft Store

Просмотрите другие элементы управления, доступные в приложении коллекции средств сообщества Windows , или попробуйте их с приложением коллекции в браузере.

Требования

Семейство устройств	Universal, 10.0.16299.0 или более поздней версии
Namespace	Microsoft.Toolkit.Uwp.UI.Controls
Пакет NuGet	Microsoft.Toolkit.Uwp.UI.Controls.DataGrid

API

• Исходный код DataGrid
• Silverlight DataGrid API