> 虚幻大学 > MASA Blazor入门这一篇就够了

MASA Blazor入门这一篇就够了

虚幻大学 xuhss 480℃ 0评论
文章目录 显示

Python微信订餐小程序课程视频

https://edu.csdn.net/course/detail/36074

Python实战量化交易理财系统

https://edu.csdn.net/course/detail/35475

1.什么是Blazor? 有什么优势？

ASP.NET Core Blazor 简介

Blazor 是一个使用 Blazor 生成交互式客户端 Web UI 的框架：

  1. 使用 C# 代替 JavaScript 来创建信息丰富的交互式 UI。
  2. 共享使用 .NET 编写的服务器端和客户端应用逻辑。
  3. 将 UI 呈现为 HTML 和 CSS，以支持众多浏览器，其中包括移动浏览器。
  4. 与新式托管平台（如 Docker）集成。

Blazor 优势：

复制代码
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6

language-markdown `1. 使用 C# 代替 JavaScript 来编写代码。

  1. 利用现有的 .NET 库生态系统。
  2. 在服务器和客户端之间共享应用逻辑。
  3. 受益于 .NET 的性能、可靠性和安全性。
  4. 在 Windows、Linux 和 macOS 上使用 Visual Studio 保持高效工作。
  5. 以一组稳定、功能丰富且易用的通用语言、框架和工具为基础来进行生成。`

    2.为什么选择MASA Blazor？能用来干什么？

MASA Blazor是一个基于 Blazor Component 和 Material Design 的 UI 组件库。
dotNET开发者不需要懂得javascript就能开发一个企业级中后台系统。
MASA Blazor优势：

  • 丰富组件：包含Vuetify 1:1还原的基础组件，以及很多实用的预置组件和.Net深度集成功能，包括Url、面包 屑、导航三联动，高级搜索，i18n等。
  • UI设计语言：设计风格现代，UI 多端体验设计优秀。
  • 简易上手：丰富详细的上手文档，免费的视频教程（制作中）。
  • 社区活跃鼓励：用户参与实时互动，做出贡献加入我们，构建最开放的开源社区。
  • 长期支持：全职团队维护，并提供企业级支持。
  • 专业示例：MASA Blazor Pro提供多种常见场景的预设布局。

MASA Blazor Pro预设布局示例：
37d36f711805c087b5917dc5cae84e9f - MASA Blazor入门这一篇就够了
1405fbeb59da50e1c68e6813dbaa95a2 - MASA Blazor入门这一篇就够了

看到这里是不是有同学对此感兴趣起来了呢！那么这样的布局页面是怎么构建出来的呢？我们自己能不能也搭建一个这样的布局呢！嘿嘿！不要着急、我们接着往下看。

3.使用MASA Blazor模板创建第一个Blazor程序

1.首先安装Masa.Template模板

（1）检查本机.Net SDK版本，请确保已安装.NET6.0

db2fd64b7a232e6ecfb344225f0e4c02 - MASA Blazor入门这一篇就够了

（2）安装 Masa.Template模板,包含 MASA 系列所有项目模板
dotnet new --install Masa.Template
023c40801058009fb030f0e83821587d - MASA Blazor入门这一篇就够了

2.创建项目

dotnet new masab -o MasaBlazorApp
默认为Server模式 可通过参数--Mode WebAssembly 创建 WebAssembly 模式项目

5890b666541d55616ae05d5ad5afda03 - MASA Blazor入门这一篇就够了

3.配置 MASA Blazor（由于我这里使用了模板，以下配置在模板中都已经帮我们配好了，安装模板后直接dotnet run 即可；未安装模板的同学，按下面步骤配置即可）

（1）安装NuGet包

复制代码
  • 1

language-mipsasmdotnet add package Masa.Blazor
1064d10450b73cf65aa5b83d1d0a9ff5 - MASA Blazor入门这一篇就够了

（2）引入资源文件（我这里为Blazor Server）

在 Pages/_Layout.cshtml 中引入资源文件
7bdd2e1efe978f68c7c5890055cf2590 - MASA Blazor入门这一篇就够了

（3）注入相关服务

在 Program.cs 中添加 Masa.Blazor 相关服务

复制代码
  • 1

language-scssbuilder.Services.AddMasaBlazor();
f195bac5c7e8d9516f964be553de1394 - MASA Blazor入门这一篇就够了

（4）修改 _Imports.razor 文件,添加以下内容:

复制代码
  • 1

language-powershell @using Masa.Blazor
（5）运行项目
d3542adf846618d0f245722d02182dcf - MASA Blazor入门这一篇就够了

到这里一个简单的MASA Blazor项目就搭建完成啦。当然这只是最基础的，接下来我们将一步一步使用MASA Blazor项目组件来丰富我们的项目。

3.使用MASA Blazor组件配置项目

示例：
ea83b5549fa28fbdbbb19a6ad0d53db6 - MASA Blazor入门这一篇就够了

（1）Blazor应用结构介绍

首先我们先来看看Blazor项目结构，分析主要几个文件的作用。（概念定义比较枯燥，想直接体验的同学可以直接跳过此部分，直接上手实践即可，但不推荐这么做，有句话说得好“磨刀不误砍柴工”

b8138143a51d16d734fe7b97de97de26 - MASA Blazor入门这一篇就够了

Program.cs

Blazor服务器应用的入口点在Program.cs文件中定义，与控制台应用一样。当应用执行时，它会使用特定于 Web 应用的默认值创建并运行 Web 主机实例。 Web 主机会管理 Blazor 服务器应用的生命周期，并设置主机级别服务。

在 Blazor 服务器应用中，显示的 Program.cs 文件用于为 Blazor 在客户端浏览器与服务器之间使用的实时连接设置终结点。
在 BlazorWebAssembly 应用中，Program.cs 文件定义应用的根组件及其呈现位置：

在Program.cs文件中我们先主要关注几个点：

1.在依赖注入中，因为我们利用了Razor来实现C#和html的混合编码以及我们使用的是ServerSide的Blazor，注入代码如下：
a7f48b4601c8d329909d8bfd765f307d - MASA Blazor入门这一篇就够了
中间件如下：
b5667df052e28c48ed304de238bb5cae - MASA Blazor入门这一篇就够了

_Host.cshtml

在Blazor服务器应用中，根组件的主机页面在_Host.cshtml文件中定义。这个文件定义一个Razor页面，而不是一个组件。Razor Pages 使用 Razor 语法定义服务器可寻址页面。

在Program.cs文件中会自动去我们配置的_Host.cshtml文件中寻找根组件
这是默认使用App组件作为根组件（这是启动Blazor应用的必要条件之一）
07b614bec70a5bfae0064fd1d766b4e9 - MASA Blazor入门这一篇就够了

那么render-mode 特性是用来干什么的呢?
让我们来看看官方文档解释：

2faf0b4bd0a6ebbed1ff7a61a8ed7954 - MASA Blazor入门这一篇就够了

App.razor
Blazor应用的根组件，里面通常包含Router组件用来处理Blazor中的路由
bee96d27dac44b3665de0c0faeaeded5 - MASA Blazor入门这一篇就够了

那么Router组件中的这些参数比如AppAssembly、Found、NotFound都有什么作用呢？

通过阅读官方文档我们可以发现：

Router 组件会在指定的 AppAssembly 和 AdditionalAssemblies（可选）中发现可路由组件。 浏览器进行导航时，如果有路由与地址匹配，Router 会拦截导航并呈现其 Found 参数的内容和提取的 RouteData，否则 Router 会呈现其 NotFound 参数。

RouteView 组件负责呈现由 RouteData 指定的匹配组件及其布局（如果有）。 如果匹配组件没有布局，则使用可选择指定的 DefaultLayout。

LayoutView 组件在指定布局内呈现其子内容

也就是说我们在配置完.razor页面的路由后，Router组件会在浏览器进行导航时将路由与地址匹配，能够匹配到的，Router就会拦截导航并呈现其Found参数指定的匹配组件和布局（我们这里指定MainLayout布局页面），反之，则呈现NotFound参数。
4d67acbfbd03df86fbf7154cfc5165b8 - MASA Blazor入门这一篇就够了

_Layout.cshtml

在之前的_Host.cshtml文件中我们默认指定启用了_Layout.cshtml布局页
9bf501544eda514dcda2e285af08b9c0 - MASA Blazor入门这一篇就够了
_Layout.cshtml是Blazor应用的主机页（相当于一个根页面布局文件），里面包含应用的初始化HTML 及其组件，它使得我们所有页面布局保持的外观变得更加的容易。

MainLayout.razor

在Blazor中，使用布局组件处理页面布局。布局组件继承自LayoutComponentBase,后者定义类型RenderFragment 的单个 Body 属性，该属性可用于呈现页面的内容。
0ec738d1ce6924b66a3642c931dc9fab - MASA Blazor入门这一篇就够了

_Imports.razor
全局导入配置，在这里使用using引入后，相当于在所有razor文件中都进行了引入。
c186c06d83b7e1350e9e0b4e3cbafb08 - MASA Blazor入门这一篇就够了

好了，废话有点多, 到这里Blazor应用部分主要结构概念差不多已经介绍完了，感兴趣的同学可自行移步官网进行阅读 面向 Web Forms ASP.NET Web Forms 开发人员的 Blazor
接下来我们直接开始撸代码

（2）使用App bars（应用栏）与Navigation drawers（导航抽屉）配置导航栏与菜单栏

上述页面展示中我们看到了三个菜单页面，这几个页面都分别配置了对应路由
Home对应页面为Index.razor、路由为"/"
6d0bbeecbc76d3d2666f44c623db422e - MASA Blazor入门这一篇就够了
1ac60cbb36f798fdc08756b2cd8f896a - MASA Blazor入门这一篇就够了

Counter对应页面为Counter.razor、路由为"/counter"
6369a4706ca7f06c250dbe19ab976cd2 - MASA Blazor入门这一篇就够了
84391825dac32f40bf724d3b0c9e5d35 - MASA Blazor入门这一篇就够了

Fetch Data页面对应FetchData.razor页面路由，路由为"/fetchdata"
在Shared/MainLayout.razor页面中我们可以看到配置。
bff48e8a1de5b46f7fe913432698c208 - MASA Blazor入门这一篇就够了

接下来我们直接移步MASA Blazor 官网地址找到我们需要的组件示例：
3f8810cc2737362ada484412321860a6 - MASA Blazor入门这一篇就够了
1f04c22344d8cedbe9b55be25067b8c9 - MASA Blazor入门这一篇就够了

我们直接将示例代码拷贝至Shared/MainLayout.razor页面中的MAppBar组件中即可
18a981c3e4d0a4932b1e835801e87527 - MASA Blazor入门这一篇就够了

dotnet run 看下效果
66df8166fad02d6ab21ed925a988c249 - MASA Blazor入门这一篇就够了

接下来我们MASA Blazor组件库中找到Navigation drawers组件，将razor页面代码与C#代码拷贝至组件中即可
10c24f4c5d92353fd9e5bb2d8f90b7d5 - MASA Blazor入门这一篇就够了
d6cde19c5585ddf2cf96376c3cbff576 - MASA Blazor入门这一篇就够了

我们对代码稍作修改
718bfcd0b005cbabc8ecec2ddbc6bc0a - MASA Blazor入门这一篇就够了

dotnet run 看下效果
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-cGiVkold-1647924407456)(https://s2.loli.net/2022/03/14/FCuGxkEwByQrjMn.png)]

下一步我们来实现动态菜单栏伸缩功能 找到Navigation drawers组件的迷你模式
b22bde8851c0de4028121cd54def1bac - MASA Blazor入门这一篇就够了

接下来我们来改造我们的代码
fc8126ca86b48d61b7a14e865b90b748 - MASA Blazor入门这一篇就够了
5b4c31baa52bdeb1dbeb697305cc402c - MASA Blazor入门这一篇就够了

dotnet run 看下效果
110e490b59ea96f6d86795ac45c630de - MASA Blazor入门这一篇就够了

是不是感觉超级简单呢！当然这只是入门写法，抛砖引玉，感兴趣的同学可以动手试试，举一反三解锁更多组件的用法与写法

（3）使用DataTable、Dialog等组件实现一个基础的数据交互页

首先我们先初始化Fetch.razor，只留一个最简单组件
6fb035e391f90d6b541c9ee61811ad9a - MASA Blazor入门这一篇就够了

DataTable组件需要至少绑定一个Headers（表头）和数据源
所以下一步我们先定义Headers与Items（实际调用API获取数据即可，这里默认死数据仅作参考）
我们先建一个Fetch.razor页的分部类，定义部分代码
e8f0b9b76cf24f16c21f99b850a75eb7 - MASA Blazor入门这一篇就够了

dotnet run 看看效果
5e29bd6e1ae39b5ddb2b7bfddfcdd535 - MASA Blazor入门这一篇就够了

在上述代码截图中会发现我们用到了OnInitializedAsync()方法，那么这个方法是用来干什么的呢？说到这个问题，我们需要先了解了解Razor组件的生命周期ASP.NET Core Razor 组件生命周期

先来看个 Component lifecycle diagram（组件生命周期图）

7a14104bcdb211e4c11fc2a19360de41 - MASA Blazor入门这一篇就够了

SetParametersAsync - 设置参数时

每当父级呈现时，都会执行此方法。
传入组件的参数包含在ParameterView中。这是根据传入组件的状态对服务器进行异步调用(例如)的好时机。
在重写中调用base.SetParametersAsync(Parameters)时，会为组件的[Parameter]属性赋值。
它也是指定默认参数值的正确位置。

OnInitialized / OnInitializedAsync - 组件初始化

将ParameterCollection中的状态分配给组件的[Parameter]属性后，将执行这些方法。这与SetParametersAsync的用法相同，不同之处在于可以使用组件的状态。

该方法仅在组件首次创建时执行一次。如果父级稍后更改组件的参数，则跳过此方法。
注意：当组件是@page，并且Blazor应用程序导航到呈现同一页面的新URL时，Blazor将为该页面重用当前对象实例。因为该对象是同一实例，所以Blazor不会对该对象调用IDisposable.Dispose，也不会再次执行其OnInitialized方法。

OnParametersSet / OnParametersSetAsync - 参数设置后

如果这是组件的新实例，则此方法将在OnInitializedAsync之后立即执行。如果它是因为其父组件正在重新呈现而正在重新呈现的现有组件，则不会执行OnInitialized*方法，而是在SetParametersAsync之后立即执行此方法。

OnAfterRender / OnAfterRenderAsync - 组件渲染后

这两个方法在Blazor每次重新生成组件的
RenderTree
时执行。这可能是因为组件的父级重新呈现、用户与组件交互(例如，鼠标单击)，或者如果组件执行其StateHasChanged方法来调用重新呈现。

了解Razor组件的生命周期后，我们来继续撸代码

我们给数据表格增加操作列
8e7e5a514c41ae9dc9f07ee4583f5c69 - MASA Blazor入门这一篇就够了
3832a82952432eeb7faf53217bb94c7d - MASA Blazor入门这一篇就够了

看下效果：
2fd57daa1a18fdf71b3143629f183e4f - MASA Blazor入门这一篇就够了
接下来我们给增加一个MDialog 对话框 用来做增加修改操作
直接将官网的示例拿过来即可
4bfbdffb9e9300fbf5a2c82e8003f7fc - MASA Blazor入门这一篇就够了
dedd0e8c89c881a834e5f79c627b11d9 - MASA Blazor入门这一篇就够了

在这过程中我们需要给Dialog组件以及组件中的其他组件使用Bind-Value（双向绑定）绑上值。
405317e6a6a4ed22aeea799dacd93d5f - MASA Blazor入门这一篇就够了
5853d1f3f2ae81f67640bfe01a25cf8d - MASA Blazor入门这一篇就够了

接下来我们给数据表格的Action操作列增加OnClick点击事件
331a40c533abed06509518cbae333036 - MASA Blazor入门这一篇就够了

对应绑定分部类中EditItem方法
3e6c25653d46c118ead3d1dd3a144935 - MASA Blazor入门这一篇就够了

我们先运行看下效果：
aff0a1c394f92e0badce55e45f2edfa2 - MASA Blazor入门这一篇就够了

960b80ad3fd594cccff7ed56058ce22d - MASA Blazor入门这一篇就够了
这两个按钮分别对应两个Button
0754566000abbf7c112e2a35fd6cf460 - MASA Blazor入门这一篇就够了

Close直接绑定后台关闭Dialog方法

062936298828ac104aaf954f5bd98e9f - MASA Blazor入门这一篇就够了

Save方法则是用来做最终修改数据等操作DB的方法这里就不做演示，感兴趣的同学可自行结合业务做相应的操作。

（4）使用预置组件应对常用业务的场景

在我们实际项目中，难免会碰到需要你开发多个模块或者多个管理页面，这样一来每个页面不可避免的会有一些需要你重复编码的地方，那么你是选择每个页面copy一份相同的代码还是选择封装一个业务组件呢？毫无疑问，聪明的同学肯定会选择后者，当然新入门的同学可以先来看看MASA Blazor提供预置组件，拿来即用，后期同学们登堂入室后可自行根据当前业务封装业务组件。

我们先来看看通用页头预置组件：
5056b05cd915bb3c106b4c152bf0b894 - MASA Blazor入门这一篇就够了
直接copy代码看看效果：
07acd1ddbcdddd03ace9499cc7334233 - MASA Blazor入门这一篇就够了

当我们数据表格中数据内容长度过长时可以使用封装好的预置组件：
看看效果：
709b9470a453e1e3bdfb9082215c9aeb - MASA Blazor入门这一篇就够了

使用方法很简单且支持复制效果：
b3abe6d3fe4e8bc0b326a015bc51c64e - MASA Blazor入门这一篇就够了
当然还有其他常用的预置组件，由于本文篇幅有限，只做个别组件使用介绍，使用方法都大差不差，感兴趣的同学可自行去官网查阅。

结尾

本文介绍内容只针对刚入门的同学，抛砖引玉，对于封装组件技巧以及组件高深用法感兴趣的同学可以关注我们同系列其他同学的文章或者直接去官网查看源码：

使用MASA Blazor开发一个标准的查询表格页以及封装技巧介绍

参考资源

开源地址

MASA.BuildingBlocks：https://github.com/masastack/MASA.BuildingBlocks

MASA.Contrib：https://github.com/masastack/MASA.Contrib

MASA.Utils：https://github.com/masastack/MASA.Utils

MASA.EShop：https://github.com/masalabs/MASA.EShop

MASA.Blazor：https://github.com/BlazorComponent/MASA.Blazor

如果你对我们的 MASA Framework 感兴趣，无论是代码贡献、使用、提 Issue，欢迎联系我们

39c846cf8e1a4bf8cf6a92e2232e07d6 - MASA Blazor入门这一篇就够了

转载请注明：xuhss » MASA Blazor入门这一篇就够了

喜欢 (0)

您必须 登录 才能发表评论！