Blazor 页面导航和路由设置教程

Blazor 路由通过 @page 指令注册页面、NavigationManager 实现跳转与参数处理，支持路径参数绑定、查询字符串解析、地址监听及手动权限拦截。

Blazor 的页面导航和路由靠 @page 指令和内置的 NavigationManager 配合实现，不需要额外安装路由库。核心是理解组件如何被识别为可访问页面、如何跳转、以及如何处理参数和导航状态。

在 Blazor 中，只要在 Razor 组件顶部加上 @page 指令，它就自动注册为一个路由路径：

所有带 @page 的组件会被 App.razor 中的自动扫描并映射，无需手动配置路由表。

在组件中注入 NavigationManager，就能实现编程式导航：

Navigation.NavigateTo("/about") —— 跳转到指定路径（默认同步，不刷新页面）
Navigation.NavigateTo("/home", forceLoad: true) —— 强制浏览器刷新（用于跳转到非 Blazor 管理的页面，如静态 HTML）
跳转前常需检查权限或保存状态，可在调用 NavigateTo 前加逻辑判断

注意：不要在组件首次渲染（OnInitialized）中直接跳转并同时修改状态，可能触发重复渲染；建议用 StateHasChanged() 或延迟执行确保安全。

路由参数自动绑定到组件的 public 属性（需匹配名称和类型），例如：

@page "/blog/{year:int}/{month:int}" 对应 public int Year { get; set; } 和 public int Month { get; set; }
查询字符串（如 ?q=blazor&sort=date）不会自动绑定，要用 NavigationManager.ToBaseRelativePath(Navigation.Uri) 解析 URL，再用 Microsoft.AspNetCore.WebUtilities.QueryHelpers.ParseQuery()

监听地址栏变化？订阅 NavigationManager.LocationChanged 事件，但记得在 Dispose 中取消订阅，避免内存泄漏。

Blazor 不自带守卫（Guard）机制，但可以手动实现：

在布局组件（如 MainLayout.razor）中检查用户登录状态，用 @if (!isLoggedIn) { }
对敏感页面，在 OnParametersSet 中校验权限，不满足时立即跳转：Navigation.NavigateTo("/unauthorized", replace: true)
想阻止离开页面（如表单未保存），目前没有原生 beforeunload 集成，需用 JS 互操作调用 window.addEventListener('beforeunload', ...)

基本上就这些 —— Blazor 路由轻量直接，关键在于把 @page、NavigationManager 和生命周期配合好，不复杂但容易忽略细节。

您的项目需求

*请认真填写需求信息，我们会在24小时内与您取得联系。