• 开包即食的教程带你浅尝最新开源的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, "
        ");
                builder.OpenElement(4, "span");
                builder.AddAttribute(5, "class", "glyphicon glyphicon-ok-circle");
                builder.AddAttribute(6, "aria-hidden", "true");
                builder.CloseElement();
                builder.AddContent(7, "
        ");
                builder.OpenElement(8, "strong");
                builder.AddContent(9, Title);
                builder.CloseElement();
                builder.AddContent(10, "
    
        Please take our
        ");
                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, "
            brief survey
        ");
                builder.CloseElement();
                builder.AddContent(16, "
        and tell us what you think.
    ");
                builder.CloseElement();
                builder.AddContent(17, "
    
    ");
            }
            #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, "
    
    ");
                builder.OpenElement(3, "p");
                builder.AddContent(4, "Current count: ");
                builder.AddContent(5, currentCount);
                builder.CloseElement();
                builder.AddContent(6, "
    
    ");
                builder.OpenElement(7, "button");
                builder.AddAttribute(8, onclick(IncrementCount));
                builder.AddContent(9, "Click me");
                builder.CloseElement();
                builder.AddContent(10, "
    
    ");
            }
            #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

  • 相关阅读:
    maven项目,去除jar包中的不想要的依赖关系
    Eclipse:An internal error occurred during: "Build Project". GC overhead limit exceeded
    如何用Maven创建web项目(具体步骤)
    让Jackson JSON生成的数据包含的中文以unicode方式编码
    MySQL存储过程详解 mysql 存储过程
    MySQL SQL Injection(注入)
    撤销Excel工作表保护密码(考勤机报表)
    youtube-dl下载视频
    LSI9240 8i在dos下刷IT直通模式
    制作DOS引导U盘(支持扩展任何dos下的程序)
  • 原文地址:https://www.cnblogs.com/supersnowyao/p/8645530.html
Copyright © 2020-2023  润新知