Blazor 怎么操作浏览器本地存储

Blazor 操作浏览器本地存储需通过 JS Interop,WASM 和 Server 均依赖此机制;推荐使用 Blazored.LocalStorage 封装库,支持强类型异步操作;也可手动实现 JS Interop;localStorage 持久共享,sessionStorage 仅限当前标签页;注意字符串限制、容量上限及敏感信息安全。

blazor 怎么操作浏览器本地存储

Blazor 操作浏览器本地存储,核心是借助 localStoragesessionStorage 这两个 Web Storage API。Blazor WebAssembly(WASM)不能直接访问浏览器存储,必须通过 JavaScript 互操作(JS Interop)调用;而 Blazor Server 虽然运行在服务端,但也能通过 JS Interop 与客户端浏览器通信完成操作——所以两种模型都依赖 JS 互操作,只是实现方式略有差异。

用 Blazored.LocalStorage 快速上手(推荐)

这是最常用、最稳定的第三方封装库,屏蔽了 JS 互操作细节,提供强类型、异步友好的 C# 接口:

安装包:dotnet add package Blazored.LocalStorageProgram.cs 中注册服务:builder.Services.AddBlazoredLocalStorage();在组件中注入使用:@inject ILocalStorageService LocalStorage存取示例:
await LocalStorage.SetItemAsync("theme", "dark");
var theme = await LocalStorage.GetItemAsync("theme");

手动 JS Interop 方式(无第三方依赖)

适合轻量场景或想完全掌控流程的项目:

wwwroot/index.html 或底部添加简易 JS 工具函数:
window.saveToStorage = (key, value) => localStorage.setItem(key, value);
window.loadFromStorage = (key) => localStorage.getItem(key);在 Blazor 组件中注入 IJSRuntime@inject IJSRuntime JSRuntime调用示例:
await JSRuntime.InvokeVoidAsync("saveToStorage", "userId", "123");
var userId = await JSRuntime.InvokeAsync("loadFromStorage", "userId");

区分 localStorage 和 sessionStorage

两者 API 完全一致,关键区别在生命周期和作用域:

localStorage:数据持久保存,关闭浏览器也不丢失,同一域名下所有标签页共享sessionStorage:仅限当前标签页,关闭该标签页即清除,适合临时状态(如表单草稿、导航历史)Blazored.LocalStorage 默认操作 localStorage;如需 sessionStorage,可额外配置或手动 JS 调用 sessionStorage.setItem

注意安全与适用边界

本地存储不是保险柜,有明确限制:

只支持字符串值,存对象需先 JsonSerializer.Serialize,读取后反序列化容量约 5–10 MB(因浏览器而异),不适合存大文件或大量二进制数据敏感信息(如 token、密码)不建议明文存 localStorage;生产环境推荐用 HttpOnly Cookie + 后端验证,或启用 ProtectedBrowserStorage(仅 Server 端支持)Blazor WASM 在私密/无痕模式下,localStorage 数据会在最后一个私密标签关闭时自动清空

基本上就这些。选 Blazored.LocalStorage 是多数项目的省心之选,手动 JS Interop 更适合教学、调试或极简集成。不需要引入复杂方案,就能稳稳把用户偏好、界面状态、轻量缓存落进浏览器里。

以上就是Blazor 怎么操作浏览器本地存储的详细内容,更多请关注创想鸟其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1443054.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年12月17日 19:40:36
下一篇 2025年12月17日 19:40:47

相关推荐

发表回复

登录后才能评论
关注微信