用途:为 Blazor Web App 提供 Syncfusion Blazor 组件的搭建与配置指南,覆盖从新建项目到测试、本地化的完整流程。
主要能力:
- 入门配置:创建指定 .NET 版本(net8.0、net9.0、net10.0 等)的 Blazor Web App,安装 Syncfusion.Blazor.Grid 与 Syncfusion.Blazor.Themes 等 NuGet 包,在 _Imports.razor 添加 @using Syncfusion.Blazor 及相关命名空间,在 Program.cs 注册 builder.Services.AddSyncfusionBlazor(),在 App.razor 添加主题 CSS 与脚本引用。Auto/WASM 模式需在服务端与客户端项目同时注册。
- 脚本加载:支持静态 Web 资产(推荐,性能佳、可离线)、CDN(云端托管、快速搭建)和单独脚本(组件用量少时)三种方式。
- bUnit 测试:安装 bunit 包,在每个测试中注册 TestContext,调用 ctx.Services.AddSyncfusionBlazor().Replace(ServiceDescriptor.Transient<IComponentActivator, SfComponentActivator>()) 并 AddOptions();测试模式为 RenderComponent<TPage>()、FindComponent<SfButton>()、.Click()、MarkupMatches(...),兼容 xUnit 与 NUnit(NUnit 用 Bunit.TestContext 避免命名冲突)。
- 本地化与全球化:区分 i18n(日期、时间、数字、货币格式化)、l10n(文化定制与 UI 文本翻译)与 globalization;从 GitHub 下载基于文化的 .resx 资源文件(下载前需申请许可),创建实现 ISyncfusionStringLocalizer 的 SyncfusionLocalizer 类,在 Program.cs 注册 AddSingleton(typeof(ISyncfusionStringLocalizer), typeof(SyncfusionLocalizer)),可静态或动态设置文化,并创建 CultureSwitcher 组件切换。
前提条件:.NET 8+ SDK、Blazor Web App 项目、Syncfusion 账户(免费试用)、NuGet 包访问权限。
限制:资料未提供具体收费、价格与效果数据;下载资源文件需先获得许可。