Blazor WebAssembly 是一个使用 C# 构建前端的框架,通过 WebAssembly 在浏览器中运行 .NET 代码。它支持组件化开发、HttpClient 调用 API、依赖注入和 PWA,可部署到静态服务器,适合 .NET 开发者高效构建交互式 Web 应用。

C# Blazor 是一个由微软开发的开源框架,允许开发者使用 C# 和 .NET 来构建交互式 Web 应用程序,而无需编写 JavaScript。Blazor 可以运行在浏览器中,通过 WebAssembly(简称 WASM)技术直接在客户端执行 C# 代码,也可以通过 SignalR 实现服务端渲染(Blazor Server)。本文主要介绍如何使用 C# 和 Blazor 开发基于 WebAssembly 的前端应用。
Blazor WebAssembly 是什么?
Blazor WebAssembly 是一种客户端 Web 框架,它将 .NET 运行时编译成 WebAssembly,并在浏览器中运行。这意味着你的 C# 代码可以直接在用户的浏览器中执行,就像 JavaScript 一样,但你不需要写一行 JS。
关键特性包括:
- 使用 C# 编写前端逻辑,复用现有 .NET 类库
- 支持依赖注入、异步编程、强类型等现代开发特性
- 可离线运行(配合 PWA 可实现渐进式 Web 应用)
- 与 HTML 和 CSS 完全兼容,组件化开发模式
如何创建一个 Blazor WebAssembly 应用?
使用 .NET SDK 可以快速创建 Blazor WebAssembly 项目。确保已安装最新版 .NET SDK(建议 6.0 或更高版本)。
打开终端并运行以下命令:
dotnet new blazorwasm -n MyBlazorAppcd MyBlazorApp
dotnet run
完成后,浏览器会自动打开 http://localhost:5000,显示默认的模板页面,包含导航、计数器示例和天气数据演示。
Blazor 的核心概念:组件化开发
Blazor 使用 Razor 组件(.razor 文件)来构建 UI。每个组件是一个兼具 HTML 标记和 C# 逻辑的文件。
例如,一个简单的计数器组件如下:
Counter
Current count: @currentCount
本系统使用的是XDcms内核,在原来基础上做来相应修改 前台修改调用数据,可以使用{loop catid=栏目ID}{/loop}方式调用 主要功能: A、内容管理模型,自定义字段,更方便扩展功能。自带模型:单页模型、新闻模型、产品模型、招聘模型 B、栏目自定义,便于内容管理 C、内容模块化,二次开发更便捷。自带模块:幻灯片、QQ客服、友情链接、自定义表单(在线留言、简历管理) D、模板管理,后台
@code {
private int currentCount = 0;
private void IncrementCount() {
currentCount++;
}
}
这里 @ 符号用于嵌入 C# 表达式或方法,@onclick 绑定点击事件,整个结构清晰易读。
与后端 API 通信
Blazor WebAssembly 本身运行在浏览器中,因此通常需要调用后端服务获取数据。可以使用内置的 HttpClient 与 RESTful API 交互。
在 Program.cs 中注册 HttpClient:
builder.Services.AddScoped(sp => new HttpClient { BaseAddress = new Uri("https://api.example.com") });然后在组件中注入并使用:
@inject HttpClient Http-
@foreach (var item in items)
{
- @item.Name }
@code { private List
protected override async Task OnInitializedAsync()
{
items = await Http.GetFromJsonAsync>("api/items");
}
}
部署 Blazor WebAssembly 应用
发布前先构建生产版本:
dotnet publish -c Release生成的静态文件位于 bin/Release/net8.0/publish/wwwroot,可部署到任意静态 Web 服务器(如 Nginx、IIS、GitHub Pages、Azure Static Web Apps 等)。
基本上就这些。Blazor WebAssembly 让你用熟悉的 C# 构建现代化前端应用,特别适合已有 .NET 技术栈的团队。虽然启动性能略慢于原生 JS,但开发效率和类型安全优势明显。不复杂但容易忽略的是对浏览器兼容性和资源加载的优化。









