Blazor OnInitializedAsync 方法使用教程

admin 百科 2025-12-12 13

OnInitializedAsync是Blazor组件首次渲染前执行一次异步初始化的核心方法，适用于加载数据、验权、读取配置等；SSR模式下需判别运行环境避免浏览器API调用错误，且不可与OnParametersSetAsync混淆。

Blazor OnInitializedAsync 方法使用教程-第1张图片-佛山资讯网

Blazor 中的 OnInitializedAsync 是组件初始化阶段执行异步逻辑的核心入口，适合加载初始数据、检查用户权限、读取配置等操作。 它在组件首次渲染前调用，且只执行一次（服务端渲染 SSR 模式下需注意两次调用问题）。正确使用能避免“数据未加载就渲染”或“重复请求”等常见问题。

什么时候该用 OnInitializedAsync？

当你需要在组件显示前完成一项或多项异步任务时，比如：

从 API 获取页面主数据（如用户详情、订单列表）
读取本地存储（localStorage 或 sessionStorage）中的用户偏好
调用身份验证服务判断登录状态
初始化依赖服务（如 SignalR 连接、WebSocket）

注意：如果只是同步赋值（如设置默认字段），用 OnInitialized 更轻量；涉及 await 就必须选 OnInitializedAsync。

基础写法与注意事项

在组件中重写该方法，返回 Task，内部用 await 调用异步操作：

@code {
    private List<Product> products = new();
    private bool isLoading = true;

    protected override async Task OnInitializedAsync()
    {
        try
        {
            products = await ProductService.GetProductsAsync();
        }
        catch (Exception ex)
        {
            // 记录错误，可设 ErrorState 显示提示
            Console.WriteLine($"加载失败: {ex.Message}");
        }
        finally
        {
            isLoading = false;
        }
    }
}

登录后复制

关键点：