在 Blazorise DataGrid 中直接显示 HTML 字符串（如 <a> 链接）时，默认会进行 HTML 编码而无法渲染为真实元素；需通过 MarkupString 显式标记可信内容，才能实现安全、可控的 HTML 渲染。
在 blazorise datagrid 中直接显示 html 字符串（如 `` 链接）时，默认会进行 html 编码而无法渲染为真实元素；需通过 `markupstring` 显式标记可信内容，才能实现安全、可控的 html 渲染。
Blazor 的默认行为是自动转义所有字符串输出，以防止 XSS 攻击。因此，即使你在数据模型中存储了 <a href="https://www.php.cn/link/b05edd78c294dcf6d960190bf5bde635">点击访问</a> 这样的字符串，Blazorise DataGrid 也会将其作为纯文本显示，而非可点击的超链接。
要正确渲染 HTML，必须将该字符串显式转换为 Microsoft.AspNetCore.Components.MarkupString 类型——这是 Blazor 提供的“信任此内容为安全 HTML”的明确信号。
✅ 推荐方案：使用 TemplateColumn（推荐且灵活）
在 DataGrid 中避免依赖自动绑定 HTML 字段，而是使用 <DataGridTemplateColumn> 手动控制单元格内容：
<DataGrid TItem="Product" Data="@products">
<DataGridColumns>
<!-- 普通字段（安全） -->
<DataGridColumn TItem="Product" Field="@nameof(Product.Name)" Caption="名称" />
<!-- 自定义 HTML 渲染列 -->
<DataGridTemplateColumn TItem="Product" Caption="操作链接">
<DisplayTemplate>
@if (context.Url is not null)
{
<a href="@context.Url" target="_blank" class="btn btn-sm btn-primary">
@context.LinkText
</a>
}
else
{
<span class="text-muted">无链接</span>
}
</DisplayTemplate>
</DataGridTemplateColumn>
</DataGridColumns>
</DataGrid>对应的数据模型示例：
立即学习“前端免费学习笔记（深入）”；
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
public class Product
{
public int Id { get; set; }
public string Name { get; set; } = string.Empty;
public string Url { get; set; } = string.Empty;
public string LinkText { get; set; } = "查看详情";
}⚠️ 替代方案：在模型中预转换为 MarkupString（慎用）
若坚持在模型中直接暴露 HTML 字符串，可在属性中返回 MarkupString：
public class Product
{
private readonly string _rawHtml;
public Product(string rawHtml) => _rawHtml = rawHtml ?? "";
public MarkupString HtmlLink => new(_rawHtml);
}并在 DataGrid 中绑定：
<DataGridColumn TItem="Product" Field="@nameof(Product.HtmlLink)" Caption="HTML 链接" />
⚠️ 重要安全提醒：
- MarkupString 绕过 Blazor 的自动转义机制，若 rawHtml 来自用户输入、数据库或外部 API，必须先严格清洗/验证 HTML（例如使用 HtmlSanitizer 库），否则将导致严重的 XSS 漏洞。
- 不建议将未过滤的用户输入直接构造成 MarkupString。
? 小结
| 方案 | 安全性 | 可维护性 | 推荐度 |
|---|---|---|---|
| TemplateColumn + 原生 HTML 标签 | ✅ 高（无动态 HTML 注入风险） | ✅ 高（逻辑清晰、易于调试） | ⭐⭐⭐⭐⭐ |
| 模型中返回 MarkupString | ❗低（需自行保障 HTML 安全） | ⚠️ 中（易误用，隐患隐蔽） | ⚠️ 仅限可信静态内容 |
始终优先选择语义化、结构化的模板渲染方式——它更符合 Blazor 的设计哲学，也更利于团队协作与长期维护。
