Skip to main content

Understanding Server-side Blazor

Introduction

We all know that the Blazor framework is a client-side web framework. But is it possible to run a Blazor application separate from UI thread? The latest version 0.5.0 of Blazor gives us the flexibility to run Blazor in a separate process from the rendering process. We are going to explore server-side Blazor in this article.

What is Server-Side Blazor?

Since Blazor is a client-side web framework, therefore the component logic and DOM interaction both happens in the same process.

Server-side Blazor

However, the design of Blazor framework is smart and flexible enough to run the application separate from rendering process. For example, we can run Blazor in a web worker thread separately from UI thread.

In this scenario, the UI thread will push the events to the Blazor worker thread and Blazor would push UI updates to the UI thread as needed. Although Blazor does not support this functionality yet, but the Blazor framework is designed to handle such scenarios and is expected to support it in future releases.

Server-side Blazor

Starting from Blazor 0.5.0, we can run Blazor application on the server. It means that we can run Blazor component server-side on .NET Core while other functionalities such as UI updates, event handling and Javascript interop calls is handled by a SignalR connection over the network. The .NET part runs under CoreCLR instead of WebAssembly which provides us the access to the complete .NET ecosystem, debugging, JIT compilation etc. This adds extensibility to the Blazor framework as the server-side Blazor uses the same component model as running a client-side Blazor app.

Server-side Blazor

Let us create our first server-side Blazor app and explore it to get a better understanding of this new feature.

Prerequisites

  • Install the .NET Core 2.1 or above SDK from here
  • Install Visual Studio 2017 v15.7 or above from here
  • Install ASP.NET Core Blazor Language Services extension from here

Visual Studio 2017 versions below v15.7 does not support Blazor framework.

Creating server-side Blazor application

Open Visual Studio and select File >> New >> Project.

After selecting the project, a “New Project” dialog will open. Select .NET Core inside Visual C# menu from the left panel. Then, select “ASP.NET Core Web Application” from available project types. Put the name of the project as ServerSideBlazor and press OK.

Server-side Blazor

After clicking on OK, a new dialog will open asking you to select the project template. You can observe two drop-down menus at the top left of the template window. Select “.NET Core” and “ASP.NET Core 2.1” from these dropdowns. Then, select “Blazor (Server-side in ASP.NET Core)” template and press OK.

Server-side Blazor

This will create our server-side Blazor solution. You can observe the folder structure in Solution Explorer, as shown in the below image:

Server-side Blazor

The solution has two project file

  1. ServerSideBlazor.App : this is our ASP.NET core hosted project.
  2. ServerSideBlazor.Server : this contains our server-side Blazor app.

All of our component logic lies in the server-side Blazor app. However, this logic does not run on client-side in browser. It runs server-side in ASP.NET Core host application. This application uses blazor.server.js for bootstrapping instead of blazor.webassembly.js used by normal blazor app. This allows the app to establish a SignalR connection over the network to handle UI updates and event forwarding. The blazor.server.js is present at “\ServerSideBlazor.App\bin\Debug\netstandard2.0\dist\_framework” folder. The <script> tag to include it in the project is present in wwwroot/index.html file.

Server-side Blazor

The blazor.server.js is the only component that separates a server-side Blazor app with a client-side Blazor app. If we provide a reference of blazor.webassembly.js instead of blazor.server.js inside the index.html file then this application will behave as a client-side Blazor app.

The Blazor app is hosted by ASP.NET Core app, which also sets up the SignalR endpoint. Since the Blazor app is running on server, the event handling logic can directly access the server resource and services.

For example, if we want to fetch any data, we no longer need to issue an HTTP request, instead we can configure a service on the server and use it to retrieve the data.

In the sample application that we have created, the WeatherForecastService is defined inside the ServerSideBlazor.App/Services folder.

using System;
using System.Linq;
using System.Threading.Tasks;

namespace ServerSideBlazor.App.Services
{
    public class WeatherForecastService
    {
        private static string[] Summaries = new[]
        {
            "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
        };

        public Task<WeatherForecast[]> GetForecastAsync(DateTime startDate)
        {
            var rng = new Random();
            return Task.FromResult(Enumerable.Range(1, 5).Select(index => new WeatherForecast
            {
                Date = startDate.AddDays(index),
                TemperatureC = rng.Next(-20, 55),
                Summary = Summaries[rng.Next(Summaries.Length)]
            }).ToArray());
        }
    }
}

Further, we need to configure the service inside ConfigureServices method in ServerSideBlazor.App/startup.cs file.

public void ConfigureServices(IServiceCollection services)
{
    services.AddSingleton<WeatherForecastService>();
}

We will inject the service into the FetchData.cshtml view page, where the method GetForecastAsync is invoked to fetch the data.

@using ServerSideBlazor.App.Services
@page "/fetchdata"
@inject WeatherForecastService ForecastService

// HTML DOM here.

@functions {
    WeatherForecast[] forecasts;

    protected override async Task OnInitAsync()
    {
        forecasts = await ForecastService.GetForecastAsync(DateTime.Now);
    }
}

Go ahead and launch the application in Google chrome. It will open a browser window and the app will look like a normal Blazor app. Open the chrome dev tool. Navigate to “Network” tab. You can observe that the application has not downloaded any .NET runtime or the app assembly.

Server-side Blazor

This is because the app is running sever-side on .NET Core. Since the dependencies are not downloaded on application boot up hence the size of app is smaller. It also has faster load time compared to normal Blazor app.

Advantage of server-side Blazor

Server-side Blazor application provides us many benefits.

  1. Since the UI update is handled over a SignalR connection so we can avoid the unnecessary page refreshes.
  2. The app download size is smaller and the initial app load is faster.
  3. The Blazor component can take full advantage of server capabilities such as using .NET Core compatible APIs.
  4. It will also support existing .NET tooling like debugging the application and JIT compilation.
  5. Since server-side Blazor runs under native .NET Core process and not under Mono WebAssembly so it is also supported on the browsers that have no WebAssembly support.

There are also few drawbacks for server-side blazor app.

  1. Since UI interaction involves SignalR communication so it adds one extra step in network call which results in a latency.
  2. The scalability of app to handle multiple client connection is also a challenge.

Summary

We have learnt about the latest server-side Blazor application introduced with Blazor 0.5.0 release and understood how it is different from the normal client-side Blazor app. We also discussed the pros and cons of using a server-side Blazor over a client-side blazor app.

Get my book Blazor Quick Start Guide to learn more about Blazor.

You can check my other articles on Blazor here 

Preparing for interviews !!! Read my article on C# Coding Questions For Technical Interviews

You can also find this article at C# Corner.

See Also

Ankit Sharma

Full Stack Consultant | GDE for Angular | Microsoft MVP | Author | Speaker | Passionate Programmer

One thought to “Understanding Server-side Blazor”

  1. Got a bit confused by this sample. Every logic is in the ServersideBlazor.App. If that is the case, what is the purse of ServersideBlazor.Server?

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.