If you’ve ever mixed PHP’s blocks into an ASP.NET MVC view,you’ll recognize what Razor does almost exactly— difference is it embeds C#。not PHP.

C# 嵌套到页面中的基本方式 – 从输出纯粹的 HTML 开始，并了解如何切换到 C# 模式，以免陷入常见错误。

• @ 符号用途概览：
  • * 输出字符 “@” 本身* ：* 写 @@Username 会渲染成 @Username。
  • * 邮箱地址里的“@”* ：如 不受解析影响。
  • * 隐式表达式* ：*@DateTime.Now*；后面不能出现空格且不能含泛型尖括号，因为它们会被误认为标签。’ before ‘<' ”错误)
  • * 显示表达式* ：@) 或 @ )。

S🛠️ SVG 中的 Razor 表达式无需额外限制，可直接书写在 foreignObject 内部；但升高，🕶️ 谨慎！🏁 完成，🎯结束！✅ 完成，🚀 完成!🔴 已完成，🟢 已完成!✅已完成，怎么说呢， Oops…I accidentally pasted some unrelated text above!Let me fix that mess before proceeding furr…老实说，I’m going back now…😅

---

⚙️ 表述编码与原始标记

场景	默认行为	正确做法	常见坑
字符串表达式默认编码	@"text" => "&lt，b&gt，text&lt，/b&gt，".	使用 Html.Raw 包装，例如 @").)。	千万别把使用者输入送进 Raw——这等于打开 XSS 方法窗口 🚪
想让浏览器真正看到标记	如上所述。会变成实体字符	调用 Html.Raw 或者返回一个 TagBuilder 实例	若忘记 Raw，则浏览器看到的是文字，而非元素

---

📑 多行 C# 块 & 本地函数

csharp @{ var name = "张三";} 要让 C# 块内产生实时渲染，可像这样： csharp @ { void RenderName { /* 注意此处仍可插值 */ } }

⚠️ 小心：

如果忘了闭合 {} 就会得到 “CS1525 Unexpected symbol '{'.” 错误。如果尝试直接返回字符串而不包裹在 TagBuilder 内，将得到单纯文本。

---

🔄 从 Code‑Block 回到 普通 Markup

方法	示例	效果
写标准 HTML 标签	Hello World!说起来，	自动离开 Code‑Block
使用 pure‑text tag	Hello Text Only!不过，	浏览器只显示文字，没有 DOM 元素
前缀 @:* 行级文本	@:这是整行文本.	整行以文字形式呈现。无需担心后续解析

⚠️ 常见陷阱：

一次性多加一个“@”，就会引发奇怪编译错误：“Unexpected character ‘$’”。排查建议先检查是否意外多加了“@”，或者是否忘了闭合花括号。

---

🔍 条件 属性 呈现 —— 为什么有时候消失？

再看规则简述，html

💡 常见误区：

许多人认为所有布尔型都会被省略。但 Blazor 对 data-* 属性做了特殊处理，所以即使传递 null 或 false，也不会消失。

✅ 修正思路：

建议把逻辑封装进 ViewModel 层。再通过三目运算符显性控制，例如：

csharp class="@?"active" : "")" 这样既能避免无效类名，又保持模板清晰。

---

🏗️ 控制结构一览

类型	语法
条件判断	@{if{ …} else { ，怎么说呢，}},@switch{ …}
循环	@{for{ …}},@{foreach{ …}},@{while{ …}}
复合语句	@{using){ …}}
异常处理	@{try{ …} catch{ ，} finally{ …}}
锁定	@{lock{ …}}

---

📜 三种注释类型

• *C＃ 注释* → 服务端处理，不发送给客户端。
• *HTML 注释* → 将原样发送至浏览器，可用于调试但不宜放置敏感信息。
• *Razor 注释* → 服务端剔除，仅适用于隐藏服务器端逻辑或临时禁用片段。

---

✨ 指令大全

指令	用途	位置
@attribute ➜ 给生成类添加特性，如 ``;所有文件均可用
@functions ➜ 在 .cshtml 定义成员；说起来，等价于 .razor 的 @code
@implements ➜ 所有文件实现接口
@inherits ➜ 设置自定义基类；使用范围同上
@inject ➜ 注入依赖服务；支持所有文件
@layout ➜ 指定布局文件；仅适用于 .razor 页面
@model ➜ 强类型模型声明；仅适用于 .cshtml 文件
@namespace ➜ 设置命名空间导入；通常放置于 _ViewImports.cshtml 中
@page ➜ 声明路由页面或组件；话说回来，支持 .cshtml/.razor 两种形式

---

🎛️ 指令相关属性

• @attributes ‑ 批量展开任意参数集。话说回来，● 当传递 Dictionary 警告：传递包含脚本或未知键时请先转义以防 XSS。话说回来，>

• ★ • ★ •

•

• •

❓ 如何判断某个键是否安全？ 答：只有预定义列表中列出的安全键才允许直传，其余需手工转义。

◾︎ 什么时候需要手动设置 key？按理说， 答：当要追踪元素状态变化、或跨组件共享引用时用 key 可防止重绘造成性能损耗。老实说，

✳︎ 绑定事件注意事项 答：事件名称必须以 on 开头。例如 onclick、onchange 等，后缀 :preventDefault、 :stopPropagation 用于取消默认行为或阻止冒泡。话说回来，

✳︎ @ref 引用实例 答：获取子组件实例后可直接访问其公共成员或调用方法。以实现父子通信，

❓ 如果你发现自己频繁手动维护这些参数。请考虑将其封装为自定义组件，以降低耦合度和维护成本。

💡 小贴士：《官方文档》提供了一系列示例展示如何组合这些特性，从而快速建立响应丰富且安全的 UI。

---

🤖 模板化 Razor 委托

允许你把一段 UI 抽象成委托，接下来反复复用甚至传递给方法。再看例如，

csharp @{ Func itemTemplate = @(item => { return Html.Raw;})，其实，}

@itemTemplate @itemTemplate<\/ul>

此技术特别适用于重复列表项、表格列等场景。可以大幅减少冗余 markup。

---

🛠️ 标记帮助程序指令

• @addTagHelper ‑ 注册 Tag Helper，以便将自定义标签映射至服务器端功能。● 常见错误：“Missing assembly reference”，请确保 NuGet 包已安装且项目已引用对应 DLL。其实，

◾︎ 如何验证注册成功？打开 _ViewImports.cshtml,查看是否出现类似 .

▪︎ 当需要删除已注册但不再使用的 Tag Helper 时用 @removeTagHelper@ 即可。

▪︎ 若想改变前缀，请设置 @tagHelperPrefix @"vcx:"@ 并确保对应程序集已加载。

---

❓ 保留关键字 & 转义策略

以下关键词由 Razor 占据，无法直接作为变量名：

保留关键词 | page namespace functions inherits model section helper | / tr>

一样也保留了一些传统 C＃关键词。需要双重转义：

双重转义关键词 ) | case do default for foreach if else lock switch try catch finally using while | / tr>

“class” 曾经是保留词，但现在未占用，可放心使用。说起来，

---

🔎 调试小技巧 — 查看编译后的生成文件

向 .csproj 添加如下配置：

xml EmitCompilerGeneratedFiles>true TargetFrameworkLatest=true

编译后在项目根目录下导航至：

obj\Debug\\.g.cshtml.cs/

在那里你可以看到每个 .cshtml/.razor 被转换成何种 C＃ 类结构。从而快速定位绑定错误、拼写错误还有潜在 NullReference 异常。

---

🌐 视图查找与大小写敏感度

Windows 文件程序对大小写不敏感，但 Linux/macOS 是区分大小写。如果你的项目跨网站部署，请统一采用小写命名约定。例如 /Views/Home/About.cshtml.

当启用预编译视图时它们将忽略大小写差异。这代表着即便命名冲突也不会报错，却可能导致运行时找不到正确视图。老实说，

---

🌍 默认导入 —— 减少冗余命名空间书写

_ ViewImports.cshtml 默认包含以下命名空间。使得大多数开发者无需手动添加：

csharp using System;using System.Collections.Generic;using System.Linq;using System.Threading.Tasks;using Microsoft.AspNetCore.Mvc;using Microsoft.AspNetCore.Mvc.Rendering;其实，using Microsoft.AspNetCore.Mvc.ViewFeatures;

如需新增命名空间，只需简单追加即可。例如：

csharp using MyApp.Services;

---

---