Blazor中JS完成时通知C#的核心是JS主动回调:用DotNetObjectReference包装C#方法传给JS,JS执行完后调用该引用上的[JSInvokable]方法;或JS返回Promise,C#用InvokeAsync await获取结果。

Blazor 中 JS 完成时获得通知,核心是利用 IJSRuntime.InvokeVoidAsync 调用 JS 函数,并在 JS 里通过 .NET 对象回调(即 JS 传回结果给 C#)。关键不是“等 JS 执行完”,而是“JS 主动通知 C# 完成了”。
用 DotNetObjectReference 从 JS 回调 C# 方法
这是最常用、最可靠的方式。C# 先把一个可被 JS 调用的方法包装成 DotNetObjectReference,再传给 JS;JS 在完成操作后,直接调用这个引用上的方法,触发 C# 端逻辑。
- C# 端:在组件中创建回调方法并生成引用
@inject IJSRuntime JSRuntime
@implements IDisposable
@code {
private DotNetObjectReference
protected override void OnInitialized() {
objRef = DotNetObjectReference.Create(this);
JSRuntime.InvokeVoidAsync("setupJsTask", objRef);
}
[JSInvokable]
public void OnJsFinished(string result) {
Console.WriteLine($"JS 已完成,返回:{result}");
StateHasChanged();
}
public void Dispose() => objRef?.Dispose();
}
- JS 端:接收引用,执行完后调用它
window.setupJsTask = (dotNetHelper) => {
// 模拟异步操作(如 fetch、动画、第三方 SDK 初始化)
setTimeout(() => {
dotNetHelper.invokeMethodAsync('OnJsFinished', '加载成功');
}, 1000);
};
用 Promise + InvokeAsync 获取 JS 返回值(适合简单同步/异步结果)
如果 JS 函数本身返回 Promise,C# 可直接 await 它,拿到 resolve 的值。适用于 JS 逻辑明确、不需复杂状态管理的场景。
- JS 端返回 Promise
window.doSomethingAsync = () => {
return new Promise((resolve) => {
setTimeout(() => resolve("JS 处理完毕"), 800);
});
};
- C# 端 await 调用,自动等待完成
var result = await JSRuntime.InvokeAsync
Console.WriteLine(result); // 输出:JS 处理完毕
注意生命周期和内存泄漏
使用 DotNetObjectReference 时,必须在组件销毁时调用 Dispose(),否则 JS 会持有对 .NET 对象的强引用,导致内存泄漏。
- 务必实现
IDisposable并释放objRef - 避免在 JS 中长期缓存
DotNetObjectReference(比如挂到 window 上) - 若 JS 需多次回调,确保 C# 方法是线程安全的(Blazor Server 下可能跨 SignalR 连接)
基本上就这些。核心就两条路:JS 主动回调(推荐用于复杂流程),或 C# await JS Promise(适合轻量交互)。选哪个取决于你的 JS 逻辑是否可控、是否需要中间状态、以及是否要复用回调。










