开包即食的教程带你浅尝最新开源的C# Web引擎Blazor
在今年年初，恰逢新春佳节临近的时候。微软给全球的C#开发者们，着实的送上了一分惊喜。微软正式开源Blazor，将.NET带回到浏览器。
这个小惊喜，迅速的在dotnet开发者中间传开了。2018年3月22日Blazor发布了它的第一次Release Blazor到底是个什么样的东西呢？我们是否真的可以携着C#语言进入前端的市场中? 不如现在就跟我一起体验dotnet blazor吧。
一、前言
获取最新版的dotnet core 并安装Blazor模板：
- 安装 最新的.Net Core（版本需要高于2.1.101）；
- 对于简单的尝试来说，VS code 已经足够。所以笔者并没有亲自安装Visual Studio；
使用命令行初始化项目：
dotnet new -i Microsoft.AspNetCore.Blazor.Templates
dotnet new blazor -o BlazorApp1
cd BlazorApp1
dotnet run
- 如果你需要使用Visual Studio：
- 安装最新的Visual Studio 2017；
- 安装 ASP.NET Core Blazor Language Services extension；
- 在Visual Studio中创建新的测试项目；
- 选择 File -> New Project -> Web -> ASP.NET Core Web Application；
- 确定在Target Framework里选择了 .NET Core and ASP.NET Core 2.0；
- 选择 Blazor 模板；
二、如何在前端渲染cshtml
当我们运行起项目之后，就可以看到如下提示：
这个时候我们在浏览器里打开监听的端口 http://localhost:17477，就可以看到我们这个项目的网页了。
这个简单的示例项目带了3个页面：
第一个页面比较简单，但先别急,让我们打开浏览器工具，先看看页面在加载页面过程中都加载了什么：
在初次打开页面的时候，我们看到的是这样一个Loading..的页面，这个页面的代码是这样的：
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<title>BlazorDemo</title>
<base href="/" />
<link href="css/bootstrap/bootstrap.min.css" rel="stylesheet" />
<link href="css/site.css" rel="stylesheet" />
</head>
<body>
<app>Loading...</app>
<script src="css/bootstrap/bootstrap-native.min.js"></script>
<script src="_framework/blazor.js" main="BlazorDemo.dll" entrypoint="BlazorDemo.Program::Main" references="Microsoft.AspNetCore.Blazor.Browser.dll,Microsoft.AspNetCore.Blazor.dll,Microsoft.Extensions.DependencyInjection.Abstractions.dll,Microsoft.Extensions.DependencyInjection.dll,mscorlib.dll,netstandard.dll,System.Core.dll,System.Diagnostics.StackTrace.dll,System.dll,System.Globalization.Extensions.dll,System.Net.Http.dll,System.Runtime.Serialization.Primitives.dll,System.Security.Cryptography.Algorithms.dll" linker-enabled="true"></script></body>
</html>
可以看到这个页面加载了两个js，第一个是bootstrap的，第二个叫做blazor.js。只不过这个js有非常多的参数，有 main、entrypoint和references。看看References里写的是不是很熟悉? 一看就是.net的dll。
blazor.js加载了mono.js，mono.js加载了mono.wasm。这个是个什么文件?
wasm代表的就是Web Assembly，简单地说它就是编译好的二进制文件，可以由浏览器直接运行，源语言可以是C/C++或者任何可以编译到Web Assembly的文件，而这里我们加载的就是mono编译好的Web Assembly文件，它被加载之后，相当于浏览器中启动了一个mono 运行环境。
随后的两个js是笔者chrome浏览器插入的js，在这里不要被他们干扰了。那么mono 运行时加载完成之后，就需要加载dotnet 的Dll了，首先是入口库，接着就是需要的引用库。
好家伙 1.9MB！当所有的Dll被下载完毕之后，这个时候我们的浏览器就可以运行我们这个dotnet的网页了。于是就回到了我们最开始看到的那个应用程序。
所以，总结一下blazor.js调用mono.js，mono.js加载mono.wsam，然后根据写在script标签里的内容继续的加载dotnet的库文件。如果浏览器不支持wsam，就会尝试使用asm.js加载mono.asm.js。
三、Blazor的模板究竟是怎样的？
我们已经知道，经过前面的步骤，浏览器里已经运行了一个.Net 运行时了。而且加载了项目必须的dll。那么这样一个简单的程序，它的代码究竟是怎么样的呢？
打开项目代码，映入眼帘的是一个标准的.net Project：
_ViewImports.cshtml包含了项目一些其他页面中最常使用的namespace：
@using System.Net.Http
@using Microsoft.AspNetCore.Blazor
@using Microsoft.AspNetCore.Blazor.Components
@using Microsoft.AspNetCore.Blazor.Layouts
@using Microsoft.AspNetCore.Blazor.Routing
@using BlazorDemo
@using BlazorDemo.Shared
Program.cs是程序的入口点：
using Microsoft.AspNetCore.Blazor.Browser.Rendering;
using Microsoft.AspNetCore.Blazor.Browser.Services;
using System;
namespace BlazorDemo
{
class Program
{
static void Main(string[] args)
{
var serviceProvider = new BrowserServiceProvider(configure =>
{
// Add any custom services here
});
new BrowserRenderer(serviceProvider).AddComponent<App>("app");
}
}
}
在入口点中，我们注册了一个浏览器渲染服务 BrowserRender，让他渲染App。
App.cshmtl是这样的：
<Router AppAssembly=typeof(Program).Assembly />
这里的Router对应的是Microsoft.AspNetCore.Blazor.Routing.Router。当给它一个AppAssembly时，他就会自动的把当前的Url 和 AppAssembly的其他Pages对应起来。
所以，当我们在浏览器里输入 /Counter时，他就会加载Pages/Couter.cshtml。
Shared文件夹里分别是布局文件、导航栏，还有一个我们自定义的控件 SurveyPrompt。
熟悉Razor引擎的小伙伴们一定很轻车熟路了。那么当我们打开网站时，默认显示给我们的就是Index，这个时候我们会加载Pages/Index.cshtml。
Index.cshtml的代码是这个样子的：
@page "/" <h1>Hello, world!</h1> Welcome to your new app. <SurveyPrompt Title="How is Blazor working for you?" />
@page 可以告诉Router，当前页面注册到 "/"。
除了显示hello world以外，我们在这里还看到了刚刚说到的第三方控件：SurveyPrompt，果然不简单嘛，一个看似简单的页面，居然还告诉了我们如何使用自定义控件。
从声明上看，我们知道SunveyPrompt是一个控件，并且有一个属性Title。现在我们打开它的代码：
<div class="alert alert-survey" role="alert">
<span class="glyphicon glyphicon-ok-circle" aria-hidden="true"></span>
<strong>@Title</strong>
Please take our
<a target="_blank" class="alert-link" href="https://go.microsoft.com/fwlink/?linkid=870381">
brief survey
</a>
and tell us what you think.
</div>
@functions
{
// This is to demonstrate how a parent component can supply parameters
public string Title { get; set; }
}
我们可以看到代码分为两部分，@functions上面是类似html的东西，下面是类似C#的东西。熟悉React或者Vue的伙伴们恐怕不会对这种混写感到陌生。这个就是Blazor的语法，Html部分很像使Razor的模板方式，而最后整个页面都会被编译成一个类，这个类派生自 Component。如果你编译过项目，你会在Debug下面的Shared目录找到一个叫SurveyPrompt.g.cs的东西：
#pragma checksum "/Users/pzhi/SCM/gitHub/zhipu123/BlazorDemo/Shared/SurveyPrompt.cshtml" "{ff1816ec-aa5e-4d10-87f7-6f4963833460}" "a2a2ea88635b799343bc6d9647bbb818c8a20c9d"
// <auto-generated/>
#pragma warning disable 1591
namespace BlazorDemo.Shared
{
#line hidden
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using System.Net.Http;
using Microsoft.AspNetCore.Blazor;
using Microsoft.AspNetCore.Blazor.Components;
using Microsoft.AspNetCore.Blazor.Layouts;
using Microsoft.AspNetCore.Blazor.Routing;
using BlazorDemo;
using BlazorDemo.Shared;
public class SurveyPrompt : Microsoft.AspNetCore.Blazor.Components.BlazorComponent
{
#pragma warning disable 1998
protected override void BuildRenderTree(Microsoft.AspNetCore.Blazor.RenderTree.RenderTreeBuilder builder)
{
base.BuildRenderTree(builder);
builder.OpenElement(0, "div");
builder.AddAttribute(1, "class", "alert alert-survey");
builder.AddAttribute(2, "role", "alert");
builder.AddContent(3, "\n ");
builder.OpenElement(4, "span");
builder.AddAttribute(5, "class", "glyphicon glyphicon-ok-circle");
builder.AddAttribute(6, "aria-hidden", "true");
builder.CloseElement();
builder.AddContent(7, "\n ");
builder.OpenElement(8, "strong");
builder.AddContent(9, Title);
builder.CloseElement();
builder.AddContent(10, "\n\n Please take our\n ");
builder.OpenElement(11, "a");
builder.AddAttribute(12, "target", "_blank");
builder.AddAttribute(13, "class", "alert-link");
builder.AddAttribute(14, "href", "https://go.microsoft.com/fwlink/?linkid=870381");
builder.AddContent(15, "\n brief survey\n ");
builder.CloseElement();
builder.AddContent(16, "\n and tell us what you think.\n");
builder.CloseElement();
builder.AddContent(17, "\n\n");
}
#pragma warning restore 1998
// This is to demonstrate how a parent component can supply parameters
public string Title { get; set; }
}
}
#pragma warning restore 1591
我们发现@functions里面的内容会作为这个类的成员变量和成员方法，而上面的内容则被编译到了BuildRenderTree方法中。
那么到了这里我们大概知道了这个简单的HomePage都有什么玄机了。我们也大概知道了Blazor的语法，也知道其实我们所有的页面最终都会是一个Componet。
那么什么是Componet呢? 在这里并不想用过多的笔墨介绍这个概念。如果你是一个Vue或者React的开发，你应该对这个模块化开发不陌生。一个Componet，就是满足一定的功能，有自己的属性、状态，可以展示特定数据的元素。
就如同我们这里的SurveyPrompt，接受一个Title属性，并且负责把它展示成这样子：
四、Blazor的刷新和绑定机制初探
现在我们知道了一个简单的页面是如何渲染出来的，那么让我们打开Counter这个配置来看一看数据是如何交互的。
我们第二个page是这样子：
有一个button，当我们点击的时候，上面的current count 变成了 1：
这一切是怎么发生的呢? 以下是Counter.cshtml的代码：
@page "/counter"
<h1>Counter</h1>
<p>Current count: @currentCount</p>
<button @onclick(IncrementCount)>Click me</button>
@functions {
int currentCount = 0;
void IncrementCount()
{
currentCount++;
}
}
我们看到这个页面非常简单，我们定义了一个CurrentCount的Field，然后在IncreaseCount方法里给它加一，一个叫Click me的button标签里有一个@onclick方法，将IncreaseCount作为参数。
Counter.cshtml编译后的代码是这样的：
#pragma checksum "/Users/pzhi/SCM/gitHub/zhipu123/BlazorDemo/Pages/Counter.cshtml" "{ff1816ec-aa5e-4d10-87f7-6f4963833460}" "05ad2dd449cbc9f09f8b759e1f06e7eb5e9583b4"
// <auto-generated/>
#pragma warning disable 1591
namespace BlazorDemo.Pages
{
#line hidden
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using System.Net.Http;
using Microsoft.AspNetCore.Blazor;
using Microsoft.AspNetCore.Blazor.Components;
using Microsoft.AspNetCore.Blazor.Layouts;
using Microsoft.AspNetCore.Blazor.Routing;
using BlazorDemo;
using BlazorDemo.Shared;
[Microsoft.AspNetCore.Blazor.Layouts.LayoutAttribute(typeof(MainLayout))]
[Microsoft.AspNetCore.Blazor.Components.RouteAttribute("/counter")]
public class Counter : Microsoft.AspNetCore.Blazor.Components.BlazorComponent
{
#pragma warning disable 1998
protected override void BuildRenderTree(Microsoft.AspNetCore.Blazor.RenderTree.RenderTreeBuilder builder)
{
base.BuildRenderTree(builder);
builder.OpenElement(0, "h1");
builder.AddContent(1, "Counter");
builder.CloseElement();
builder.AddContent(2, "\n\n");
builder.OpenElement(3, "p");
builder.AddContent(4, "Current count: ");
builder.AddContent(5, currentCount);
builder.CloseElement();
builder.AddContent(6, "\n\n");
builder.OpenElement(7, "button");
builder.AddAttribute(8, onclick(IncrementCount));
builder.AddContent(9, "Click me");
builder.CloseElement();
builder.AddContent(10, "\n\n");
}
#pragma warning restore 1998
int currentCount = 0;
void IncrementCount()
{
currentCount++;
}
}
}
#pragma warning restore 1591
我们看到@onclick其实在这里就是执行了一个Component的一个方法onclick，顾名思义，当这个Component被点击的时候就被调用。我们的IncreaseCount被作为参数传给了它，可见onclick会在被点击的时候执行IncreaseCount。
那么问题来了，当我们执行了IncreaseCount方法时，页面怎么会知道要不要刷新? 是刷新整个页面还是刷新所有?
熟悉WPF的同学可能知道，在WPF中如果我们需要让一个ViewModel可以被监听变化，它就需要实现INotifyChanged事件。那么同样道理，我们的这个IncreaseCount可能也是类似的吗?
然而基于编译后的代码我们可以发现 CurrentCount作为我们Counter这个类的Field，并没有任何机会高速Page自己变化了。而且这个Field非常普通，也不是什么WPF中的DP（依赖属性），所以到目前为止变化是怎么通知的。并没有一个合理的解释。后面的时间里我会尝试阅读Blazor的代码搞清楚这件事情。
第一个问题画个问号，那么第二个问题呢?
打开浏览器工具，定位到button，再次点击button观察dom的反应。
我们看到 在点击Button的时候，button上面的<p>标签闪动了，说明它被刷新了，而其他标签并没有。所以局部刷新的功能是有的，效率问题不用担心了。
编辑Click me，把他的内容变成 "点击我"，再次点击按钮，我们看到还是只有p变，而且button也没有变回原来的内容：
所以我们知道，这个局部刷新不是简单的拿Dom作比较，肯定是有Virtual Dom的机制在里面。
五、星星之火,可燎原?
在简单的尝试了Blazor之后，还是很兴奋的。可以看到Blazor是一个初具规模的产品，我们C#开发可以用Blazor在今后写前端渲染的网页了！
我很期望这样一个产品能够持续的演进下去。
就目前版本看（0.1.0）Blazor尚不能应用到产品中。主要还是有以下的原因：
- 打包大小太大，1.8M的大小对于网站简直是致命的；
- 产品还不成熟，现在Component还只能支持简单的事件，笔者测试的时候只有onclick，onchange；
- 兼容性差，使用了WebAssembly，就注定了两年前的浏览器必定不能支持；
当然我们还是不能否认，Blazor为如何让更多语言进入前端世界打开了一扇新的大门。也许未来JavaScript将不仅仅是前端唯一可以使用的利器。我们会看到C/C++、Python、Java写的前端渲染页面也不一定呢。
当然在后端语言打入前端世界的道路上，WebAssembly也未必是唯一的方法，比如Scala.js就完全使用了js重写了Scala的库函数，类似的还有Kotlin.js。可以看到虽然JavaScript已经非常Fancy了，但是后端程序员们进军前端的热情可谓从未停歇过啊。
转载链接：https://www.cnblogs.com/Gerryz/p/get-start-with-dotnet-blazor.html
posted on 2018-03-25 17:14 SuperSnowYao 阅读(4830) 评论(4) 编辑 收藏 举报
