ComponentBase.OnAfterRenderAsync(Boolean) Method

Reference

Definition

Namespace:: Microsoft.AspNetCore.Components

Assembly:: Microsoft.AspNetCore.Components.dll

Package:: Microsoft.AspNetCore.Components v3.0.3

Package:: Microsoft.AspNetCore.Components v3.1.18

Package:: Microsoft.AspNetCore.Components v5.0.9

Package:: Microsoft.AspNetCore.Components v6.0.6

Package:: Microsoft.AspNetCore.Components v7.0.5

Package:: Microsoft.AspNetCore.Components v8.0.0-rc.1.23421.29

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Method invoked after each time the component has been rendered interactively and the UI has finished updating (for example, after elements have been added to the browser DOM). Any ElementReference fields will be populated by the time this runs.

This method is not invoked during prerendering or server-side rendering, because those processes are not attached to any live browser DOM and are already complete before the DOM is updated.

Note that the component does not automatically re-render after the completion of any returned Task, because that would cause an infinite render loop.

protected:
 virtual System::Threading::Tasks::Task ^ OnAfterRenderAsync(bool firstRender);

protected virtual System.Threading.Tasks.Task OnAfterRenderAsync (bool firstRender);

abstract member OnAfterRenderAsync : bool -> System.Threading.Tasks.Task
override this.OnAfterRenderAsync : bool -> System.Threading.Tasks.Task

Protected Overridable Function OnAfterRenderAsync (firstRender As Boolean) As Task

Parameters

firstRender: Boolean

Set to true if this is the first time OnAfterRender(Boolean) has been invoked on this component instance; otherwise false.

Returns

Task

A Task representing any asynchronous operation.

Remarks

The OnAfterRender(Boolean) and OnAfterRenderAsync(Boolean) lifecycle methods are useful for performing interop, or interacting with values received from @ref. Use the firstRender parameter to ensure that initialization work is only performed once.

Applies to