ASP.NET Core: State Management in Blazor Applications

Posted by: Mahesh Sabnis , on 6/14/2021, in Category ASP.NET Core
Views: 522523
Abstract: State Management is one of the much-needed features in modern web applications. In this Blazor Tutorial, we will be discussing about the state management features provided by ASP.NET Core Blazor in browsers, which can save a round trip to the server.

Blazor is a framework for building interactive client-side Web UI using .NET.

Blazor provides features to create RICH and interactive UI using C# instead of JavaScript. It provides a full-stack application development experience with end-to-end support from .NET, which allows the sharing of logic written on server-side to the client application.

Web UI developed using Blazor has support from all the modern browsers, including mobile browsers. Blazor renders HTML and CSS on the browser for interactive UI. One advantage of Blazor is that it supports .NET libraries from the .NET ecosystem.

One of the major concepts in Blazor is a Component.

A Component is an object which is rendered in the browser and this object is responsible for providing interactivity to the end user so that the data entered by the end user can be manipulated and then used for processing.

A component is an autonomous object which contains user interface, data as well as behaviour. This behaviour is bound with various UI elements of the component using data binding as well as event binding.

Elements of the component may be standard HTML elements used for defining layout of the component e.g. Div, Table etc., as well as the standard Blazor components e.g. InputText, InputNumber, InputSelect, etc. Using these standard components, interactivity can be provided to end-users.

A component can contain multiple child components in it.

These components can talk to each other by sharing some data across them. In this case, a parent component sends data to the child component, and the chid component can emit data back to parent component using an event.

The communication can be established across components as well without a parent-child relationship. This results into a disconnected communication across the components. In the case of disconnected communication across components, State is maintained by a Global State Container Object. This object is managed in the global scope of the application as a singleton object in the dependency container.

Figure 1 provides an idea of State Management using a Blazor application.

state-management-blazor

Figure 1: The State Management in Blazor App

As shown in Figure 1, the global state object must be defined. This object must define property (or properties) that will be used to maintain the state of data to be shared across the components. This object also defines an event.

The event is raised when the sender component modifies its state and updates the previous state of the value – from global state container object, to new state. The public method in this object will be accessed by the sender component to send the new state to the global object. Once the state is changed in the global object, the other receiver component can subscribe to the global state object and receive the modified state.

 

State Management in Blazor – Implementation

In this Blazor Tutorial, we will be discussing about the state management features provided by Blazor. We will be designing this application targeting .NET 5 and we will be using Visual Studio 2019 for writing code.

Step 1: Open Visual Studio 2019 and create a new Blazor Web Assembly Project as shown in Figure 2:

blazor-web-assembly-project

Figure 2: The Blazor Web Assembly Project

Click on the Next button and name this project as Blazor_StateManagement as shown in the Figure 3:

setting-blazor-project-name

Figure 3: Setting the Project Name

After providing a project name, click on the Next button. A new window will be displayed as shown in Figure 4. In this window, select the Target Framework and other details as needed by the project

dotnet5-famework-selection

Figure 4: The Framework selection

Note: Since this tutorial focuses on Blazor State Management – other features like Authentication Type, ASP.NET Core Hosted, etc. features have been omitted.

Adding Model Classes

Step 2: In the project, add a new folder and name it as Models. In this folder, add a new class file and name it as ModelClasses.cs. In this file, add code as shown in listing 1.

 

public class Category
{
    public int CategoryId { get; set; }
    public string CategoryName { get; set; }
}

public class Categories : List<Category>
{
    public Categories()
    {
        Add(new Category() { CategoryId = 1, CategoryName = "C1" });
        Add(new Category() { CategoryId = 2, CategoryName = "C2" });
    }
}

public class Product
{
    public int ProductId { get; set; }
    public string ProductName { get; set; }
    public int CategoryId { get; set; }
}

public class Products : List<Product>
{
    public Products()
    {
        Add(new Product() { ProductId = 101, ProductName = "P1", CategoryId = 1 });
        Add(new Product() { ProductId = 102, ProductName = "P2", CategoryId = 2 });
        Add(new Product() { ProductId = 103, ProductName = "P3", CategoryId = 1 });
            Add(new Product() { ProductId = 104, ProductName = "P4", CategoryId = 2 });
    }
}

Listing 1: The Model classes

The code in listing 1 contains Category and Product classes. The Categories and Products classes contains default data. This data will be displayed in the UI. The CategoryId is a property used to establish relationship across Category and Product classes.

Adding the Global State Container Class

Step 3: As explained in figure 1, to maintain the state of the data across sender to receiver components, we need to create a global state container service class. In the project, add a new folder and name it as StateService. In this folder, add a new class file and name it as StateContainerService. In this file, add code as shown in Listing 2.

public class StateContainerService
{
    /// <summary>
    /// The State property with initial value
    /// </summary>
    public int Value { get; set; } = 0;
    /// <summary>
    /// The event that will be raised for state changed
    /// </summary>
    public event Action OnStateChange;

    /// <summary>
    /// The method that will be accessed by the sender component 
    /// to update the state
    /// </summary>
    public void SetValue(int value)
    {
        Value = value;
        NotifyStateChanged();
    }

    /// <summary>
    /// The state change event notification
    /// </summary>
    private void NotifyStateChanged() => OnStateChange?.Invoke();
}

Listing 2: The state container service

The code in listing 2 shows the following important features of the StateContainer services.

1. ‘Value’ is the state property declared as integer with default value as 0. This value will be changed by the sender component.

2. ‘OnStateChange’ is an event. This event will be raised when the state is changed.

3. ‘NotifyStateChanged()’ is the method that will be used to raise the OnStateChange event when the state is changed.

4. ‘SetValue()’ method will be invoked by the sender component to modify the old state to the new state. Once the state is changed then the ‘NotifyStateChanged()’ method will be called to raise the state changed event.

Step 4: Modify the Program.cs and register StateContainerService into the dependency container as singleton object as shown below.

builder.Services.AddSingleton<StateContainerService>();

Adding Components

 

Step 5: Right-Click on the ‘Pages’ folder and select add new ‘Razor Component’ as shown in the Figure 5:

adding-razor-component

Figure 5: Adding new Razor Component

Name this component as CategorySenderComponent.razor. Repeat this process to add a new Razor Component and name it as ProductReceiverComponent.razor.

Step 6: In the CategorySenderComponent, add code as shown in the listing 3.

@page "/categorysendercomponent"
@using Blazor_StateManagement.Models;
@inject StateService.StateContainerService stateService;
@implements IDisposable
@inject NavigationManager uriHelper;
<h3>Category Sender Component</h3>

<div class="container">
    <table class="table table-bordered table-striped">
        <thead>
            <tr>
                <th>Category Id</th>
                <th>Category Name</th>
            </tr>
        </thead>
        <tbody>
            @foreach (var cat in categories)
            {
                <tr>
                    <td>@cat.CategoryId</td>
                    <td>@cat.CategoryName</td>
                    <td>
                        <input type="button" @onclick="@(()=>SelectedCategoey(cat.CategoryId))" value="Select" />
                    </td>
                </tr>
            }
        </tbody>
    </table>
</div>


@code {
    private Category category;
    private Categories categories;

    protected override void OnInitialized()
    {
        category = new Category();
        categories = new Categories();
        stateService.OnStateChange += StateHasChanged;
    }
    void SelectedCategoey(int catid)
    {
        stateService.SetValue(catid);
        uriHelper.NavigateTo("/productreceivercomponent");

    }
    public void Dispose()
    {
        stateService.OnStateChange -= StateHasChanged;
    }
}

Listing 3: The CategorySenderComponent

The code in listing 3 for the CategorySenderComponent does the following:

1. The component is injected with StateContainerService and NavigationManager classes. We have already seen details of the StateContainerService. The NavigationManager class provides methods to navigate across the components.

2. The OnInitialized() method is used to initialize Category and Categories objects. The most important part in this method is that the component subscribes to the OnStateChange event of the StateContainerService using the StateHasChanged() method. The StateHasChanged() method indicates that the state of the component has changed. This subscription indicates that when the component’s state is changed, it raises an event on the state container service to make sure that the state property is changed to the new value.

3. The SelectedCategory() method of the component class is bound to the click event of the button element rendered inside the table. This method invokes the SetValue() method of the StateContainerService class to update the state. The SelectedCategory() method then navigates to the productreceivercomponent.

4. The Dispose() method unsubscribe the OnStateChange event.

Step 7: In the ProductReceiverComponent.razor, add code as shown in the Listing 4

@page "/productreceivercomponent"
@using Blazor_StateManagement.Models;
@inject StateService.StateContainerService stateService;
@implements IDisposable
@inject NavigationManager uriHelper;
<h3>Product Receiver Component</h3>

<div class="container">
    <h2>The Received Category Id is = @CatId</h2>
    <table class="table table-bordered table-striped">
        <thead>
            <tr>
                <th>Product Id</th>
                <th>Product Name</th>
                <th>Category Id</th>
            </tr>
        </thead>
        <tbody>
            @foreach (var prd in filteredProducts)
            {
                <tr>
                    <td>@prd.ProductId</td>
                    <td>@prd.ProductName</td>
                    <td>@prd.CategoryId</td>

                </tr>
            }
        </tbody>
    </table>
</div>


@code {
    private Products products;
    private List<Product> filteredProducts;
    private int CatId;
    protected override void OnInitialized()
    {
                

        products = new Products();
        filteredProducts = new List<Product>();

        CatId = stateService.Value;

        if (CatId == 0)
        {
            filteredProducts = products;
        }
        else
        {
            filteredProducts = products.Where(p => p.CategoryId == CatId).ToList();
        }



    }
    public void Dispose()
    {
         stateService.OnStateChange -= StateHasChanged;
     
    }
}

Listing 4: The ProductReceiverComponent

Like the CategorySenderComponent, the ProductReceiverComponent is also injected by the StateContainerService. The OnInitialized() method accesses the modified state from the StateContainerService class using its Value property. Once the modified state is received, the ProductReceiverComponent filters Products data based on the Category data received from the State. The ProductRenderComponent renders products based on the CategoryId.

Step 8: Modify the NavMenu.razor component in the Shared folder and add navigation links for Category and Product components as shown in the listing 5.

<li class="nav-item px-3">
    <NavLink class="nav-link" href="categorysendercomponent">
        <span class="oi oi-list-rich" aria-hidden="true"></span> Category 
    </NavLink>
</li>
<li class="nav-item px-3">
    <NavLink class="nav-link" href="productreceivercomponent">
        <span class="oi oi-list-rich" aria-hidden="true"></span> Product 
    </NavLink>
</li>

Listing 5: The navigation links

Running the Blazor Application

Run the application to load it in the browser as shown in the Figure 6:

blazor-application-in-browser

Figure 6: The application loaded in the browser

Click on the ’Category’ link and the CategorySenderComponent will be loaded as shown in the Figure 7:

category-sender-component

Figure 7: The CategorySenderComponent

 

Click on the Select button of the Category Name ‘C1’, the Product Receiver Component will be displayed with the Products in category C1 as shown in Figure 8:

product-receiver-component

Figure 8: The ProductReceiverComponent

The Product Receiver Component shows Products based on the selected category. A few questions that come to the mind are:

Where is the state in stored?

Is the state stored in the browser?

If yes, then where is the state is maintained?

Here we must understand that we have developed a Blazor WebAssembly project.

The WebAssembly project loads the .NET assemblies in the browser and the application’s execution is managed in the browser. To see all these assemblies, press F12 button to open the developer tools as shown in Figure 9.

Note: I have run this application on Windows 10 machine with Chrome installed on it. A similar experience can be seen on a MacBook with Microsoft Edge and Chrome browsers.

On a Safari browser on MacBook, please use following steps to view Blazor Resources downloaded

Toolbar > Develop Menu > Show JavaScript Console.

developer-tools-for-blazor-applications

Figure 9: Developer tools

As shown in Figure 9, in the Application tab, select Cache Storage. This shows .NET assemblies loaded in the browser. In this tab in the ‘Filter by Path’ textbox, enter Blazor_StateManagement, this will the current application assembly loaded in the browser as shown in figure 10:

blazor-assembly-for-application

Figure 10: The Application assembly loaded in the browser

The application assembly also contains the StateContainerService class to maintain state in the browser. Instead of using any of the browser resources, state is maintained by the application itself and it can be easily shared across all the components.

Conclusion:

 

State Management is one of the much-needed features in modern web applications. The advantage of it is that since the data is managed in the browser, frequent postbacks to the server can be avoided.

Most of the front-end JavaScript Libraries and frameworks e.g., React, Angular, etc. provides State Management by using a Global State Container object (aka Store). In Blazor applications (Web Assembly project), we can easily implement State Management using Global State Container Object because the application with its dependencies is loaded and executed in the browser.

Note: Unfortunately due to the lack of time and resources, this article could not be reviewed  technically. 

 

This article has been editorially reviewed by Suprotim Agarwal.

Absolutely Awesome Book on C# and .NET

C# and .NET have been around for a very long time, but their constant growth means there’s always more to learn.

We at DotNetCurry are very excited to announce The Absolutely Awesome Book on C# and .NET. This is a 500 pages concise technical eBook available in PDF, ePub (iPad), and Mobi (Kindle).

Organized around concepts, this Book aims to provide a concise, yet solid foundation in C# and .NET, covering C# 6.0, C# 7.0 and .NET Core, with chapters on the latest .NET Core 3.0, .NET Standard and C# 8.0 (final release) too. Use these concepts to deepen your existing knowledge of C# and .NET, to have a solid grasp of the latest in C# and .NET OR to crack your next .NET Interview.

Click here to Explore the Table of Contents or Download Sample Chapters!

What Others Are Reading!
Was this article worth reading? Share it with fellow developers too. Thanks!
Share on LinkedIn
Share on Google+

Author
Mahesh Sabnis is a DotNetCurry author and a Microsoft MVP having over two decades of experience in IT education and development. He is a Microsoft Certified Trainer (MCT) since 2005 and has conducted various Corporate Training programs for .NET Technologies (all versions), and Front-end technologies like Angular and React. Follow him on twitter @maheshdotnet or connect with him on LinkedIn


Page copy protected against web site content infringement 	by Copyscape




Feedback - Leave us some adulation, criticism and everything in between!