Share via


QuickGrid<TGridItem> Classe

Definição

Um componente que exibe uma grade.

[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

Parâmetros de tipo

TGridItem

O tipo de dados representado por cada linha na grade.

Herança
QuickGrid<TGridItem>
Atributos
Implementações

Construtores

QuickGrid<TGridItem>()

Constrói uma instância de QuickGrid<TGridItem>.

Propriedades

AdditionalAttributes

Obtém ou define uma coleção de atributos adicionais que serão aplicados ao elemento criado.

ChildContent

Define os componentes filho dessa instância. Por exemplo, você pode definir colunas adicionando componentes derivados da ColumnBase<TGridItem> classe base.

Class

Um nome de classe CSS opcional. Se for dado, isso será incluído no atributo de classe da tabela renderizada.

ItemKey

Opcionalmente, define um valor para @key em cada linha renderizada. Normalmente, isso deve ser usado para especificar um identificador exclusivo, como um valor de chave primária, para cada item de dados.

Isso permite que a grade preserve a associação entre elementos de linha e itens de dados com base em seus identificadores exclusivos, mesmo quando as instâncias do TGridItem são substituídas por novas cópias (por exemplo, após uma nova consulta no armazenamento de dados subjacente).

Se não estiver definido, a @key será a própria instância do TGridItem.

Items

Uma fonte de dados que pode ser consultada para a grade.

Isso pode ser dados na memória convertidos em consultáveis usando o AsQueryable(IEnumerable) método de extensão ou um EntityFramework DataSet ou um IQueryable derivado dele.

Você deve fornecer ou ItemsItemsProvider, mas não ambos.

ItemSize

Isso é aplicável somente ao usar Virtualize. Ele define uma altura esperada em pixels para cada linha, permitindo que o mecanismo de virtualização busque o número correto de itens para corresponder ao tamanho da exibição e garantir uma rolagem precisa.

ItemsProvider

Um retorno de chamada que fornece dados para o rid.

Você deve fornecer ou ItemsItemsProvider, mas não ambos.

Pagination

Opcionalmente, vincula essa QuickGrid<TGridItem> instância a um PaginationState modelo, fazendo com que a grade busque e renderize apenas a página de dados atual.

Normalmente, é usado em conjunto com um componente Paginator ou alguma outra lógica de interface do usuário que exiba e atualize a instância PaginationState fornecida.

Theme

Um nome de tema, com o valor padrão "default". Isso impacta quais regras de estilo correspondem à tabela.

Virtualize

Se for true, a grade será renderizada com virtualização. Normalmente, isso é usado juntamente com a rolagem e faz com que a grade busque e renderize apenas os dados em torno do visor de rolagem atual. Isso pode melhorar muito o desempenho de rolagem em grandes conjuntos de dados.

Se você usar Virtualize, deverá fornecer um valor para ItemSize e deve garantir que cada linha seja renderizada com a mesma altura constante.

Geralmente, é preferível não usar Virtualize se a quantidade de dados que estão sendo renderizados for pequena ou se você estiver usando paginação.

Métodos

BuildRenderTree(RenderTreeBuilder)

Um componente que exibe uma grade.

DispatchExceptionAsync(Exception)

Trata o fornecido exception como sendo gerado por esse componente. Isso fará com que o ErrorBoundary delimitador faça a transição para um estado com falha. Se não houver errorboundary delimitador, ele será considerado como uma exceção do renderizador delimitador.

Isso é útil se ocorrer uma exceção fora dos métodos de ciclo de vida do componente, mas você deseja tratá-la da mesma forma que uma exceção de um método de ciclo de vida do componente.

(Herdado de ComponentBase)
DisposeAsync()

Um componente que exibe uma grade.

InvokeAsync(Action)

Executa o item de trabalho fornecido no contexto de sincronização do renderizador associado.

(Herdado de ComponentBase)
InvokeAsync(Func<Task>)

Executa o item de trabalho fornecido no contexto de sincronização do renderizador associado.

(Herdado de ComponentBase)
OnAfterRender(Boolean)

Método invocado após cada vez que o componente é renderizado interativamente e a interface do usuário termina a atualização (por exemplo, depois que elementos são adicionados ao DOM do navegador). Todos os ElementReference campos serão preenchidos quando isso for executado.

Esse método não é invocado durante a pré-geração ou a renderização do lado do servidor, pois esses processos não estão anexados a nenhum DOM do navegador dinâmico e já estão concluídos antes que o DOM seja atualizado.

(Herdado de ComponentBase)
OnAfterRenderAsync(Boolean)

Método invocado após cada vez que o componente é renderizado interativamente e a interface do usuário termina a atualização (por exemplo, depois que elementos são adicionados ao DOM do navegador). Todos os ElementReference campos serão preenchidos quando isso for executado.

Esse método não é invocado durante a pré-geração ou a renderização do lado do servidor, pois esses processos não estão anexados a nenhum DOM do navegador dinâmico e já estão concluídos antes que o DOM seja atualizado.

Observe que o componente não é renderizado automaticamente após a conclusão de qualquer retornado Task, pois isso causaria um loop de renderização infinito.

OnInitialized()

Método invocado quando o componente está pronto para iniciar, tendo recebido seus parâmetros iniciais de seu pai na árvore de renderização.

(Herdado de ComponentBase)
OnInitializedAsync()

Método invocado quando o componente está pronto para iniciar, tendo recebido seus parâmetros iniciais de seu pai na árvore de renderização.

Substitua esse método se você executar uma operação assíncrona e quiser que o componente seja atualizado quando essa operação for concluída.

(Herdado de ComponentBase)
OnParametersSet()

Método invocado quando o componente recebeu parâmetros de seu pai na árvore de renderização e os valores de entrada foram atribuídos às propriedades.

(Herdado de ComponentBase)
OnParametersSetAsync()

Método invocado quando o componente recebeu parâmetros de seu pai na árvore de renderização e os valores de entrada foram atribuídos às propriedades.

RefreshDataAsync()

Instrui a grade a buscar novamente e renderizar os dados atuais da fonte de dados fornecida (ou ItemsItemsProvider).

SetParametersAsync(ParameterView)

Define parâmetros fornecidos pelo pai do componente na árvore de renderização.

(Herdado de ComponentBase)
ShouldRender()

Retorna um sinalizador para indicar se o componente deve ser renderizado.

(Herdado de ComponentBase)
ShowColumnOptionsAsync(ColumnBase<TGridItem>)

Exibe a interface do ColumnOptions usuário da coluna especificada, fechando qualquer outra interface do usuário de opções de coluna exibida anteriormente.

SortByColumnAsync(ColumnBase<TGridItem>, SortDirection)

Define a coluna de classificação atual da grade como a especificada column.

StateHasChanged()

Notifica o componente de que seu estado foi alterado. Quando aplicável, isso fará com que o componente seja renderizado novamente.

(Herdado de ComponentBase)

Implantações explícitas de interface

IComponent.Attach(RenderHandle)

Um componente que exibe uma grade.

(Herdado de ComponentBase)
IHandleAfterRender.OnAfterRenderAsync()

Um componente que exibe uma grade.

(Herdado de ComponentBase)
IHandleEvent.HandleEventAsync(EventCallbackWorkItem, Object)

Um componente que exibe uma grade.

(Herdado de ComponentBase)

Aplica-se a