ComponentBase Classe

  • Referência

Definição

Namespace:
Microsoft.AspNetCore.Components
Assembly:
Microsoft.AspNetCore.Components.dll
Pacote:
Microsoft.AspNetCore.Components v3.0.3
Pacote:
Microsoft.AspNetCore.Components v3.1.18
Pacote:
Microsoft.AspNetCore.Components v5.0.9
Pacote:
Microsoft.AspNetCore.Components v6.0.6
Pacote:
Microsoft.AspNetCore.Components v7.0.5
Pacote:
Microsoft.AspNetCore.Components v8.0.0

Classe base opcional para componentes. Como alternativa, os componentes podem implementar IComponent diretamente.

public ref class ComponentBase abstract : Microsoft::AspNetCore::Components::IComponent, Microsoft::AspNetCore::Components::IHandleAfterRender, Microsoft::AspNetCore::Components::IHandleEvent
public abstract class ComponentBase : Microsoft.AspNetCore.Components.IComponent, Microsoft.AspNetCore.Components.IHandleAfterRender, Microsoft.AspNetCore.Components.IHandleEvent
type ComponentBase = class
    interface IComponent
    interface IHandleEvent
    interface IHandleAfterRender
Public MustInherit Class ComponentBase
Implements IComponent, IHandleAfterRender, IHandleEvent
Herança
Object
ComponentBase
Derivado
Implementações
IComponent IHandleAfterRender IHandleEvent

Construtores

ComponentBase()

Constrói uma instância de ComponentBase.

Métodos

BuildRenderTree(RenderTreeBuilder)

Renderiza o componente para o fornecido RenderTreeBuilder.
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.
InvokeAsync(Action)

Executa o item de trabalho fornecido no contexto de sincronização do renderizador associado.
InvokeAsync(Func<Task>)

Executa o item de trabalho fornecido no contexto de sincronização do renderizador associado.
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 os elementos são adicionados ao DOM do navegador). Todos ElementReference os 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.
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 forem adicionados ao DOM do navegador). Todos ElementReference os 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 nenhum 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.
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.
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.
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.
SetParametersAsync(ParameterView)

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

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

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

Implantações explícitas de interface

IComponent.Attach(RenderHandle)

Classe base opcional para componentes. Como alternativa, os componentes podem implementar IComponent diretamente.
IHandleAfterRender.OnAfterRenderAsync()

Classe base opcional para componentes. Como alternativa, os componentes podem implementar IComponent diretamente.
IHandleEvent.HandleEventAsync(EventCallbackWorkItem, Object)

Classe base opcional para componentes. Como alternativa, os componentes podem implementar IComponent diretamente.

Aplica-se a