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

Blazor 操作浏览器本地存储,核心是借助 localStorage 或 sessionStorage 这两个 Web Storage API。Blazor WebAssembly(WASM)不能直接访问浏览器存储,必须通过 JavaScript 互操作(JS Interop)调用;而 Blazor Server 虽然运行在服务端,但也能通过 JS Interop 与客户端浏览器通信完成操作——所以两种模型都依赖 JS 互操作,只是实现方式略有差异。
用 Blazored.LocalStorage 快速上手(推荐)
这是最常用、最稳定的第三方封装库,屏蔽了 JS 互操作细节,提供强类型、异步友好的 C# 接口:
安装包:dotnet add package Blazored.LocalStorage在 Program.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
微信扫一扫
支付宝扫一扫