QuickGrid<TGridItem> Класс

Определение

Компонент, отображающий сетку.

[Microsoft.AspNetCore.Components.CascadingTypeParameter("TGridItem")]
public class QuickGrid<TGridItem> : Microsoft.AspNetCore.Components.ComponentBase, IAsyncDisposable
[<Microsoft.AspNetCore.Components.CascadingTypeParameter("TGridItem")>]
type QuickGrid<'GridItem> = class
    inherit ComponentBase
    interface IAsyncDisposable
Public Class QuickGrid(Of TGridItem)
Inherits ComponentBase
Implements IAsyncDisposable

Параметры типа

TGridItem

Тип данных, представленных каждой строкой в сетке.

Наследование
QuickGrid<TGridItem>
Атрибуты
Реализации

Конструкторы

Имя Описание
QuickGrid<TGridItem>()

Создает экземпляр QuickGrid<TGridItem>.

Свойства

Имя Описание
AdditionalAttributes

Возвращает или задает коллекцию дополнительных атрибутов, которые будут применены к созданному элементу.

Assets

ResourceAssetCollection Возвращает приложение.

(Унаследовано от ComponentBase)
AssignedRenderMode

Возвращает назначенный этому компоненту IComponentRenderMode .

(Унаследовано от ComponentBase)
ChildContent

Определяет дочерние компоненты этого экземпляра. Например, можно определить столбцы, добавив компоненты, производные от ColumnBase<TGridItem> базового класса.

Class

Необязательное имя класса CSS. Если это задано, это будет включено в атрибут класса отрисоваемой таблицы.

ItemKey

При необходимости определяет значение для @key каждой отрисованной строки. Обычно это следует использовать для указания уникального идентификатора, например значения первичного ключа для каждого элемента данных.

Это позволяет сетке сохранять связь между элементами строк и элементами данных на основе их уникальных идентификаторов, даже если экземпляры TGridItem заменяются новыми копиями (например, после нового запроса к базовому хранилищу данных).

Если этот параметр не задан, @key он будет самим экземпляром TGridItem.

Items

Запрашиваемый источник данных для сетки.

Это может быть данные в памяти, преобразованные в запросы с помощью AsQueryable(IEnumerable) метода расширения, или EntityFramework DataSet или производных IQueryable от него.

Вы должны указать либо Items или ItemsProvider, но не оба.

ItemSize

Это применимо только при использовании Virtualize. Он определяет ожидаемую высоту в пикселях для каждой строки, что позволяет механизму виртуализации получить правильное количество элементов для сопоставления размера дисплея и обеспечить точную прокрутку.

ItemsProvider

Обратный вызов, предоставляющий данные для сетки.

Вы должны указать либо Items или ItemsProvider, но не оба.

OnRowClick

Необязательно. Обратный вызов, который вызывается при щелчке строки.

OverscanCount

Это применимо только при использовании Virtualize. Он определяет, сколько дополнительных элементов будет отображаться до и после видимого региона, чтобы уменьшить частоту отрисовки во время прокрутки. Хотя более высокие значения могут повысить плавность прокрутки, отрисовка дополнительных элементов вне экрана, они также могут увеличить время начальной загрузки. Рекомендуется найти баланс на основе размера набора данных и требований к пользовательскому интерфейсу. Значение по умолчанию — 3.

Pagination

При необходимости связывает этот QuickGrid<TGridItem> экземпляр с PaginationState моделью, что приводит к выборке сетки и отрисовке только текущей страницы данных.

Обычно это используется в сочетании с компонентом Paginator или другой логикой пользовательского интерфейса, которая отображает и обновляет предоставленный PaginationState экземпляр.

RendererInfo

RendererInfo Возвращает компонент, на котором выполняется работа.

(Унаследовано от ComponentBase)
RowClass

Необязательно. Обратный вызов для каждой отрисованной строки для указания класса CSS.

Theme

Имя темы с значением по умолчанию "default". Это влияет на то, какие правила стилизации соответствуют таблице.

Virtualize

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

Если используется Virtualize, необходимо указать значение ItemSize и убедиться, что каждая строка отображается с одинаковой высотой констант.

Как правило, предпочтительнее не использовать Virtualize , если объем отрисовываемых данных мал или если используется разбиение на страницы.

Методы

Имя Описание
BuildRenderTree(RenderTreeBuilder)

Компонент, отображающий сетку.

DispatchExceptionAsync(Exception)

Обрабатывает предоставленный exception компонент как создаваемый этим компонентом. Это приведет к переходу заключающей границы ошибки в состояние сбоя. Если границы ошибок не заключены, он будет рассматриваться как исключение из заключиющего отрисовщика.

Это полезно, если исключение возникает за пределами методов жизненного цикла компонента, но вы хотите обработать его так же, как исключение из метода жизненного цикла компонента.

(Унаследовано от ComponentBase)
DisposeAsync()

Компонент, отображающий сетку.

HideColumnOptionsAsync()

Закрывает ранее отображаемый ColumnOptions пользовательский интерфейс.

InvokeAsync(Action)

Выполняет предоставленный рабочий элемент в контексте синхронизации связанного отрисовщика.

(Унаследовано от ComponentBase)
InvokeAsync(Func<Task>)

Выполняет предоставленный рабочий элемент в контексте синхронизации связанного отрисовщика.

(Унаследовано от ComponentBase)
OnAfterRender(Boolean)

Метод вызывается после каждого запуска компонента в интерактивном режиме, а пользовательский интерфейс завершил обновление (например, после добавления элементов в браузер DOM). Все ElementReference поля будут заполнены по времени выполнения.

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

(Унаследовано от ComponentBase)
OnAfterRenderAsync(Boolean)

Метод вызывается после каждого отрисовки компонента в интерактивном режиме, и пользовательский интерфейс завершил обновление (например, после добавления элементов в браузер DOM). Все ElementReference поля будут заполнены по времени выполнения.

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

Обратите внимание, что компонент не выполняет автоматическую отрисовку после завершения возвращаемого Taskобъекта, так как это приведет к бесконечному циклу отрисовки.

OnInitialized()

Метод вызывается, когда компонент готов к запуску, получив свои начальные параметры от родительского элемента в дереве отрисовки.

(Унаследовано от ComponentBase)
OnInitializedAsync()

Метод вызывается, когда компонент готов к запуску, получив свои начальные параметры от родительского элемента в дереве отрисовки.

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

(Унаследовано от ComponentBase)
OnParametersSet()

Метод вызывается, когда компонент получил параметры от родительского элемента в дереве отрисовки, а входящие значения были назначены свойствам.

(Унаследовано от ComponentBase)
OnParametersSetAsync()

Метод вызывается, когда компонент получил параметры от родительского элемента в дереве отрисовки, а входящие значения были назначены свойствам.

RefreshDataAsync()

Указывает сетке повторно получить и отобразить текущие данные из предоставленного источника данных ( Items или ItemsProvider).

SetParametersAsync(ParameterView)

Задает параметры, предоставляемые родительским элементом компонента в дереве отрисовки.

(Унаследовано от ComponentBase)
ShouldRender()

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

(Унаследовано от ComponentBase)
ShowColumnOptionsAsync(ColumnBase<TGridItem>)

ColumnOptions Отображает пользовательский интерфейс для указанного столбца, закрывая любой ранее отображаемый пользовательский интерфейс параметров столбца.

SortByColumnAsync(ColumnBase<TGridItem>, SortDirection)

Задает текущий столбец сортировки сетки указанным column.

StateHasChanged()

Уведомляет компонент о том, что его состояние изменилось. Если применимо, это приведет к повторной отрисовки компонента.

(Унаследовано от ComponentBase)

Явные реализации интерфейса

Имя Описание
IComponent.Attach(RenderHandle)

Компонент, отображающий сетку.

(Унаследовано от ComponentBase)
IHandleAfterRender.OnAfterRenderAsync()

Компонент, отображающий сетку.

(Унаследовано от ComponentBase)
IHandleEvent.HandleEventAsync(EventCallbackWorkItem, Object)

Компонент, отображающий сетку.

(Унаследовано от ComponentBase)

Применяется к