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
@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<List<Item>>("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,但开发效率和类型安全优势明显。不复杂但容易忽略的是对浏览器兼容性和资源加载的优化。
