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。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

更多
string转int
string转int

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

1091

2023.08.02

css中float用法
css中float用法

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

598

2024.04.28

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

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

108

2025.10.23

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

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

256

2023.09.22

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

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

1174

2024.03.01

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

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

781

2023.08.03

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

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

221

2023.09.04

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

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

1571

2023.10.24

Python WebSocket实时通信与异步服务开发实践
Python WebSocket实时通信与异步服务开发实践

本专题聚焦 Python 在实时通信场景中的开发实践,系统讲解 WebSocket 协议原理、长连接管理、消息推送机制以及异步服务架构设计。内容包括客户端与服务端通信实现、连接稳定性优化、消息队列集成及高并发处理策略。通过完整案例,帮助开发者构建高效稳定的实时通信系统,适用于聊天应用、实时数据推送等场景。

7

2026.03.18

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Laravel---API接口
Laravel---API接口

共7课时 | 0.7万人学习

ThinkPHP6.x 微实战--十天技能课堂
ThinkPHP6.x 微实战--十天技能课堂

共26课时 | 1.9万人学习

ThinkPHP6.x API接口--十天技能课堂
ThinkPHP6.x API接口--十天技能课堂

共14课时 | 1.2万人学习

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

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