0

0

Blazor 路由参数类型约束使用教程

畫卷琴夢

畫卷琴夢

发布时间:2026-02-01 08:18:09

|

194人浏览过

|

来源于php中文网

原创

Blazor路由参数类型约束可提前拦截非法URL,避免运行时异常;需在@page中声明约束(如{id:int}),组件参数类型必须严格匹配,支持基础类型、函数约束、可选参数及通配符捕获。

blazor 路由参数类型约束使用教程

Blazor 路由参数类型约束能帮你提前拦截非法 URL,避免运行时类型转换失败或逻辑异常。关键在于:约束写在 @page 模板里,而组件参数类型必须严格匹配约束要求。

基础类型约束(如 int、bool、guid)

直接在路由占位符后加冒号和类型名,例如 {id:int}。框架会自动尝试将 URL 中的字符串转为对应类型,失败则不匹配该路由(跳转到 NotFound 页面)。

  • @page "/product/{id:int}" 要求 URL 必须是 /product/123 这类整数结尾,/product/abc/product/12.5 都不会命中
  • 组件中对应参数必须声明为 public int Id { get; set; },不能是 string 或可空 int?(除非你用可选参数 + 默认值逻辑)
  • 常见支持类型包括:intlongbooldatetimeguidfloatdouble

函数约束(如 max、min、regex)

函数约束只接受 string 类型的参数,框架不会自动转换。它是在字符串层面做验证,不是类型转换。

  • 写法示例:@page "/user/{name:regex(^[a-zA-Z]{2,20}$)}",限制 name 只能是 2–20 个英文字母
  • 数值范围约束如 {id:max(100)},实际接收的是 string,但值必须能解析为 ≤100 的整数(否则不匹配)
  • 组件属性必须是 public string Name { get; set; },否则编译或运行时会出错
  • 多个约束可叠加,比如 {id:int:min(1):max(999)},但注意 int 是类型约束,min/max 是函数约束,顺序不影响效果

可选参数与默认值处理

在参数名后加问号 ? 表示可选,URL 中可以省略该段。但组件仍需提供合理默认值,否则可能为 null 或 0。

一糖导航
一糖导航

一糖导航丨实用的上网导航资源网址导航

下载
  • 写法:@page "/profile/{username?}",允许访问 /profile/profile/john
  • 参数属性建议设为可空或带默认值,例如 public string Username { get; set; } = "guest";
  • 推荐在 OnParametersSet 中设置默认值,因为该方法每次参数变化都会触发,比 OnInitialized 更可靠

通配符捕获(catch-all)

{*path} 捕获 URL 剩余全部路径段,适合构建动态嵌套路由或代理页面。

  • 写法:@page "/docs/{*slug}",可匹配 /docs/intro/docs/api/v1/users/list 等任意深度
  • 对应参数必须是 string 类型,且允许为 null,例如 public string? Slug { get; set; }
  • 注意:catch-all 参数必须放在模板末尾,且一个路由只能有一个

基本上就这些。约束不是装饰,它直接影响路由是否生效,写完记得测试各种非法输入——比如故意输个字母进 {id:int},看是不是真跳 404。

相关文章

路由优化大师
路由优化大师

路由优化大师是一款及简单的路由器设置管理软件,其主要功能是一键设置优化路由、屏广告、防蹭网、路由器全面检测及高级设置等,有需要的小伙伴快来保存下载体验吧!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

503

2023.08.02

css中float用法
css中float用法

css中float属性允许元素脱离文档流并沿其父元素边缘排列,用于创建并排列、对齐文本图像、浮动菜单边栏和重叠元素。想了解更多float的相关内容,可以阅读本专题下面的文章。

580

2024.04.28

C++中int、float和double的区别
C++中int、float和double的区别

本专题整合了c++中int和double的区别,阅读专题下面的文章了解更多详细内容。

103

2025.10.23

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

237

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

479

2024.03.01

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

361

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

212

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1503

2023.10.24

2026赚钱平台入口大全
2026赚钱平台入口大全

2026年最新赚钱平台入口汇总,涵盖任务众包、内容创作、电商运营、技能变现等多类正规渠道,助你轻松开启副业增收之路。阅读专题下面的文章了解更多详细内容。

54

2026.01.31

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Git 教程
Git 教程

共21课时 | 3.2万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.3万人学习

Kotlin 教程
Kotlin 教程

共23课时 | 3.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号