如何让Razor组件订阅外部C#类库事件（.NET MAUI Blazor Hybrid）

核心思路 #

要实现Razor组件订阅外部C#类库的事件并自动重新渲染，关键在于正确管理事件订阅/取消订阅，并在事件触发时通知Blazor组件更新UI。以下是分步实现方案：

步骤1：准备外部类库的服务与事件 #

假设你的类库中有一个后台任务服务，定义如下：

// 类库中的服务类
public class BackgroundTaskService
{
    // 自定义事件，携带任务完成信息
    public event EventHandler<TaskCompletedEventArgs>? TaskCompleted;

    // 启动后台任务的异步方法
    public async Task StartBackgroundTasksAsync()
    {
        // 模拟后台任务逻辑
        await Task.Delay(3000);
        // 任务完成时触发事件
        TaskCompleted?.Invoke(this, new TaskCompletedEventArgs 
        { 
            TaskId = 1, 
            Status = "执行完成" 
        });
    }
}

// 自定义事件参数类
public class TaskCompletedEventArgs : EventArgs
{
    public int TaskId { get; set; }
    public string Status { get; set; } = string.Empty;
}

步骤2：在MAUI项目中注册服务 #

在Program.cs中将类库的服务注册到依赖注入容器（推荐单例或作用域，根据实际需求选择）：

builder.Services.AddSingleton<BackgroundTaskService>();

步骤3：实现Razor组件的事件订阅与渲染更新 #

在SomeComponent.razor中完成事件订阅、状态更新和资源清理：

@inject BackgroundTaskService TaskService
@implements IDisposable

<div>
    <h3>当前任务状态：@CurrentStatus</h3>
</div>

@code {
    private string CurrentStatus = "等待任务启动";

    protected override void OnInitialized()
    {
        // 组件初始化时订阅事件
        TaskService.TaskCompleted += HandleTaskCompleted;
        // 启动后台任务（也可在页面/其他组件中触发）
        _ = TaskService.StartBackgroundTasksAsync();
    }

    private void HandleTaskCompleted(object? sender, TaskCompletedEventArgs e)
    {
        // 更新组件状态
        CurrentStatus = $"任务[{e.TaskId}]：{e.Status}";
        // 事件可能在后台线程触发，需切换到UI线程通知渲染更新
        InvokeAsync(StateHasChanged);
    }

    public void Dispose()
    {
        // 组件销毁时取消事件订阅，避免内存泄漏
        TaskService.TaskCompleted -= HandleTaskCompleted;
    }
}

关键注意事项 #

• 内存泄漏防护：必须实现IDisposable接口，在组件销毁时取消事件订阅，防止类库服务持有组件引用导致内存泄漏。
• 线程安全：类库的后台事件大概率在非UI线程触发，因此必须用InvokeAsync(StateHasChanged)确保UI更新操作在Blazor的UI线程执行。
• 服务生命周期匹配：如果注册的是作用域服务，要确保组件的生命周期与服务生命周期对齐，避免服务已释放但组件仍持有订阅。
• 性能优化：若事件触发频繁，可添加防抖逻辑（比如延迟更新状态），避免组件过度渲染影响性能。

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