Partilhar via


Virtualize<TItem> Classe

Definição

Fornece funcionalidade para renderizar uma lista virtualizada de itens.

generic <typename TItem>
public ref class Virtualize sealed : Microsoft::AspNetCore::Components::ComponentBase, IAsyncDisposable
public sealed class Virtualize<TItem> : Microsoft.AspNetCore.Components.ComponentBase, IAsyncDisposable
type Virtualize<'Item> = class
    inherit ComponentBase
    interface IAsyncDisposable
Public NotInheritable Class Virtualize(Of TItem)
Inherits ComponentBase
Implements IAsyncDisposable

Parâmetros de tipo

TItem

O context tipo para os itens que estão sendo renderizados.

Herança
Virtualize<TItem>
Implementações

Construtores

Nome Description
Virtualize<TItem>()

Fornece funcionalidade para renderizar uma lista virtualizada de itens.

Propriedades

Nome Description
Assets

Obtém o ResourceAssetCollection para o aplicativo.

(Herdado de ComponentBase)
AssignedRenderMode

Obtém o IComponentRenderMode atribuído a esse componente.

(Herdado de ComponentBase)
ChildContent

Obtém ou define o modelo de item para a lista. Consulte ItemContent.

EmptyContent

Obtém ou define o conteúdo a ser mostrado quando Items estiver vazio ou quando for TotalItemCount zero.

ItemContent

Obtém ou define o modelo de item para a lista.

Items

Obtém ou define a fonte de item fixa.

ItemSize

Obtém o tamanho de cada item em pixels. O padrão é 50px.

ItemsProvider

Obtém ou define a função que fornece itens para a lista.

MaxItemCount

Obtém ou define o número máximo de itens que serão renderizados, mesmo que o cliente informe que seu visor é grande o suficiente para mostrar mais. O valor padrão é 100.

Isso só deve ser usado como uma proteção contra o uso excessivo de memória ou grandes cargas de dados. Não defina isso como um número menor do que você espera ajustar em uma janela de tamanho realista, pois isso deixará uma lacuna em branco abaixo e o usuário pode não conseguir ver o restante do conteúdo.

OverscanCount

Obtém ou define um valor que determina quantos itens adicionais serão renderizados antes e depois da região visível. Isso ajuda a reduzir a frequência de renderização durante a rolagem. No entanto, valores mais altos significam que mais elementos estarão presentes na página.

Placeholder

Obtém ou define o modelo para itens que ainda não foram carregados na memória.

RendererInfo

Obtém o RendererInfo componente em execução.

(Herdado de ComponentBase)
SpacerElement

Obtém ou define o nome da marca do elemento HTML que será usado como o espaçador de virtualização. Um desses elementos será renderizado antes dos itens visíveis e mais um depois deles, usando um estilo explícito de "altura" para controlar o intervalo de rolagem.

O valor padrão é "div". Se você estiver colocando a Virtualize<TItem> instância dentro de um elemento que requer um nome de marca filho específico, considere defini-la aqui. Por exemplo, ao renderizar dentro de um "corpo", considere a configuração SpacerElement para o valor "tr".

Métodos

Nome Description
BuildRenderTree(RenderTreeBuilder)

Renderiza o componente para o fornecido RenderTreeBuilder.

(Herdado de ComponentBase)
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 uma exceção ocorrer 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 de componente.

(Herdado de ComponentBase)
DisposeAsync()

Fornece funcionalidade para renderizar uma lista virtualizada de itens.

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 de atualizar (por exemplo, depois que os 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 sã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 tiver sido renderizado interativamente e a interface do usuário tiver terminado de atualizar (por exemplo, depois que os elementos tiverem sido 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 sã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 retorno Task, porque isso causaria um loop de renderização infinito.

(Herdado de ComponentBase)
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.

(Herdado de ComponentBase)
RefreshDataAsync()

Instrui o componente a solicitar novamente dados de sua ItemsProvider. Isso é útil se os dados externos podem ter sido alterados. Não é necessário chamar isso ao usar Items.

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)
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

Nome Description
IComponent.Attach(RenderHandle)

Fornece funcionalidade para renderizar uma lista virtualizada de itens.

(Herdado de ComponentBase)
IHandleAfterRender.OnAfterRenderAsync()

Fornece funcionalidade para renderizar uma lista virtualizada de itens.

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

Fornece funcionalidade para renderizar uma lista virtualizada de itens.

(Herdado de ComponentBase)

Aplica-se a