ASP.NET WebForms中派生控件如何等待基类异步OnLoad事件完成？

你当前的问题核心在于：基类OnLoad中调用Page.RegisterAsyncTask只是将异步任务提交给页面调度，并不会立即等待任务完成。派生类的OnLoad是同步执行的，在调用base.OnLoad(e)后马上执行SomeDerivedValue = base.SomeBaseValue * 2时，基类的PageLoadAsync还在异步执行，SomeBaseValue尚未被数据库返回的值赋值，因此得到的是默认值0。

下面提供两种可行的解决方案：

方案一：重构基类异步逻辑，派生类统一注册异步任务 #

修改基类，将异步加载逻辑封装为可被派生类调用的方法，派生类在自己的异步任务中先等待基类数据加载完成，再处理自身逻辑：

基类代码修改：

public class BaseUserControl : UserControl
{
    public int SomeBaseValue { get; set; }

    protected override void OnLoad(EventArgs e)
    {
        base.OnLoad(e);
        // 移除原有注册逻辑，交由派生类统一处理
    }

    // 封装基类异步加载逻辑为受保护方法
    protected async Task LoadBaseDataAsync()
    {
        SomeBaseValue = await GetBaseValueFromDB();
    }
}

派生类代码修改：

public class EmployeeUserControl : BaseUserControl
{
    public int SomeDerivedValue { get; set; }

    protected override void OnLoad(EventArgs e)
    {
        base.OnLoad(e);
        // 注册包含基类+派生类逻辑的异步任务
        Page.RegisterAsyncTask(new PageAsyncTask(async () =>
        {
            await LoadBaseDataAsync();
            SomeDerivedValue = SomeBaseValue * 2;
        }));
    }
}

方案二：基类保留异步任务注册，派生类等待基类任务完成 #

如果需要保留基类原有的异步任务注册逻辑，可以在基类中暴露异步任务的Task实例，让派生类的异步任务等待其完成：

基类代码修改：

public class BaseUserControl : UserControl
{
    public int SomeBaseValue { get; set; }
    // 暴露基类异步任务的Task实例，供派生类等待
    protected Task _baseLoadCompletionTask;

    protected override void OnLoad(EventArgs e)
    {
        base.OnLoad(e);
        _baseLoadCompletionTask = PageLoadAsync();
        Page.RegisterAsyncTask(new PageAsyncTask(() => _baseLoadCompletionTask));
    }

    public async Task PageLoadAsync()
    {
        SomeBaseValue = await GetBaseValueFromDB();
    }
}

派生类代码修改：

public class EmployeeUserControl : BaseUserControl
{
    public int SomeDerivedValue { get; set; }

    protected override void OnLoad(EventArgs e)
    {
        base.OnLoad(e);
        // 注册派生类自己的异步任务，先等待基类任务完成
        Page.RegisterAsyncTask(new PageAsyncTask(async () =>
        {
            await _baseLoadCompletionTask;
            SomeDerivedValue = SomeBaseValue * 2;
        }));
    }
}

关键注意事项 #

• 确保页面的@Page指令中设置了Async="true"，否则页面不会处理注册的异步任务：

  <%@ Page Language="C#" Async="true" ... %>
  

• 不要在同步的OnLoad方法中直接await异步方法（即不要将OnLoad改为async void），这会破坏WebForms的页面生命周期，可能导致不可预测的问题。

内容的提问来源于stack exchange，提问作者Swamy